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Bytestalker Software Analyzer Card 


Old-fashioned computers always came with a front panel, loaded 
with lights and switches. You could usually stop a program, 
single-step it, and even set a breakpoint address to halt 
execution at a particular address. Personal computers don't 
include front panels, but now you can add part of one to your 
Apple. J. Stuart Enterprises, Box 310, Grass Valley, CA 95945, 
is offering the Bytestalker Software Analyzer Card. The card 
includes 16 switches for selecting a breakpoint address, a 
three-position mode switch (run, stop, trap), and a two 
position step-hold switch. There are also six single hex digit 
displays, to show you address and contents. You can choose 
Single-stepping at the machine cycle level, or the instruction 
level. The price is only $88.50, plus postage and insurance. 
Contact J. Stuart at the above address or at phone 

(916) 273-9188. 


We're Gaining on it... 


We've gained about a week in our efforts to get AAL back on 
schedule: it looks like the April issue will actually get to 
the printer during April! Next month we'll be shooting to get 
the May issue in the mail before the end of May, and soon 
you'll be receiving each month's issue during the appropriate 
month. Thanks for your patience. 


80-Column Screen Display Subroutine.......Bob Sander-Cederlof 


In the very first issue of AAL, back in October 1980, I wrote 
an article about an interpretive screen display subroutine. A 
lot of things have happened since 1980! Although perhaps it is 
insignificant compared to the rise and fall of nations, one 
change which dramatically affects Apple programmers is that now 
almost everything is done on an 80-column screen. That old 
message printer was tied to the 40-column screen, so I think an 
upgrade is in order. 


The following program has more features than the 1980 version, 
and is also easier to use. Another nice change since 1980 is 
that most of the assemblers available for the Apple now include 
a macro capability. Macros make it easier to use special coded 
sequences of bytes like those necessary in the message printer. 


Where is the message? 


There are many different ways to tell a message-printing 
subroutine where the message to be printed is located in 
memory. The method I used in my 1980 article was to assign a 
message number to each message, and pass that number in the 
A-register; the message printer used the message number as an 
index to a table of message addresses. Sometimes I have used 
the message number technique without a table of message 
addresses: I put all the messages together in one consecutive 
area Of memory; the meSsage printer searched through the 
messages counting end-of-message characters until it found the 
N-th message, and then started printing. 


I show two other techniques in the program which follows. The 
first one involves loading the full address of the message to 
be printed into the A- and Y-registers. In my program I put 
the high-byte of the address in the Y-register, and the 
low-byte in the A-register. Of course you could use any 
registers any way you wish, but this is what I used. The code 
for MESSAGE.PRINTER is shown in lines 1250-1380. I defined a 
Macro named “MSG"° in lines 1190-1230 to make it easier to write 
the code to call the message printer. Calls to the message 
printer may be written simply as one-line macro calls, such as: 


>MSG TITLE 
>MSG COPYRIGHT 


where TITLE and COPYRIGHT are the names of specific messages 
assembled elsewhere in a program. 


The other technique I show here is probably the most popular 
one, if the programs I have disassembled are any indication. 
In this method the text of the message to be printed 
immediately follows the JSR to the message printer. The 
message printer uses the return address placed on the stack by 
the JSR to locate the message. After the message is printed, 
the return address is modified so that it points to the next 
instruction after the message before RTSing. 

ANOTHER .MESSAGE.PRINTER is shown in lines 1420-1640. 
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S-C Macro Assembler Version 2.0......DOS $100, ProDOS $100, both for $120 
Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownerS.....ccccccccccccces S20 
ProDOS Upgrade Kit for Version 2.0 DOS ownerS..cccccccccccccccecccsese e930 
Source Code of S-C Macro 2.0 (DOS or ProDOS)........each, additional $100 
S-C Disassembler (ProDOS only)...without source code $30, with source $50 
RAK-Ware DISASM (DOS only).......-without source code $30, with source $50 
ProVIEW (ProDOS OT DY) io voices Bawa SS wire evel ain aa Sew, etd aoe Wee oe ae ee eee oo 20 
Full Screen Editor for S-C Macro (with complete source code) ......2+e+949 
S-C Cross Reference Utility......without source code $20, with source $50 
S-C Word Processor (with complete Source COdE) .cccccccccccesececccceee SO 
DP18 and DPFP, including complete source and object Ccode.....eeeeee0e2950 
ES-CAPE (Extended S-C Applesoft Program Editor) .......... 

Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners) ....$30 
Bag of Tricks 2 (Quality Software) .....ccccccccccvccesccccee (949.95) $45 
MacASM -- Macro Assembler for MacIntosh (Mainstay)........-($150.00) $50 
S-C Documentor (complete commented source code of Applesoft ROMS).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 

(Available: 6800/1/2, 6301, 6805, 6809, 68000, Z-80, 2-8, 8048, 
8051, 8085, 1802/4/5, PDP-1l1, GI1650/70, others) 

Beagle Bros. Applesoft Compiler (ProDOS only) ..-..cecccceeeee ($74.95) $65 * 


+ & 


AAL Quarterly DiSkS.....ccccccccccccccceeeee@acn $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


* 


Diskettes (with hub rings) ......cccccccccceseeseeee package of 25 for $15 
Vinyl disk pages, 6"°x8.5", hold two disks each.......ecccceceese-lL0 for $6 * 
Diskette Mailing Protectors (hold 1 or 2 disks).............40 cents each 
(Cardboard folders designed to fit 6"°X9" Envelopes.) or $25 per 100 * 
Envelopes for Diskette MallerS.....cccccccccvcccscsececcsee 6 CeNtS each 


65802 Microprocessor (Western DeSign Center) ...cseccceceseceeee (995) $50 
quikLoader EPROM System (SCRG)...ccccccccsccccsvcscccssvecceseee (91/9) $170 
PROMGRAMER (SCRG) ...ccccccccccccccscccccccsscccsccscccccccccs (9149.50) $140 
Minuteman 250 Uninterruptible Power Supply.....ccccccccveceese ($359) $320 
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"Apple //gs Technical Reference", FiSCher...ccccseccvcccceces (919.95) $19 
"65816/65802 Assembly Language Programming", Fischer......-. ($21.95) $20 
"Programming the 65816", EyeS..ccccccccvcccscccccscccccsssce (922.99) $21 
"Apple //e Reference Manual", Apple Computer......ccccccecsee ($24.95) $23 
"Apple //c Reference Manual", Apple Computer.....cccccceccees ($24.95) $23 
"ProDOS Technical Reference Manual", Apple Computer........-($29.95) $27 
“Apple ProDOS: Advanced Features for Programmers", Little..($17.95) $17 
"“ProDOS Inside and Out", Doms & Weishaar....c.ccccccceccvecee ($16.95) $16 
"DOStalk Scrapbook", Weishaar & KersSey....cccccccceccecccccee (914.95) $14 
"Beneath Apple ProDOS", Worth & Lechner.....cccccccccccvecee (919.95) $18 
"Beneath Apple DOS", Worth & LeEChHner......crccceccccsecccceee (919.95) $18 
"Inside the Apple //c%, Little... cccrceccccccccccsccvecceccces (919.95) $18 
“Inside the Apple //e", Little.......... pets bis eaee wee esicigeaee (Sloss) SIB 
“Understanding the Apple //e", Sather... .ccecccccccvecccsccce (924.99) $23 
“Understanding the Apple II", Sather... .cwcccccerccvccscseee ($22.99) $21 
"Apple II+/Ile Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
"Apple ][{ Circuit Description", Gayler....ccccccccccsccecceee (922.99) $21 
"Assem. Language for Applesoft Programmers", Finley & Myers.($18.95) $18 
"Now That You Know Apple Assembly Language...", Gilder......($19.95) $18 
“Enhancing Your Apple II, vol. 1°, LancaSter...csccceccccese ($15.95) $15 
"Enhancing Your Apple II, vol. 2%, Lancaster....ccccccccccee(Sl7.95) $17 
"Assembly Cookbook for the Apple II/IIe", Lancaster.......-.($21.95) $20 
"Microcomputer GraphicS", MYErS..ccceccccccccccscsccscvesesee (914.95) $14 
"Assembly Lines -- the Book", WaGneLr..ccccccccccceccvevcesess (919.95) $18 
"AppleVisions", Bishop & GrOSSDELGeL...ccccccccvcccscsccecse (939.99) $36 
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* On these items add $2.00 for the first item and 
$.75 for each additional item for US shipping. 
+ Inquire for shipping cost. 
Foreign customers inquire for postage needed. 
Texas residents please add 7.25 % sales tax to all orders. 


a*&*x S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
week (214) 324-2050 wee 
*** Master Card, VISA, Discover and American Express *** 
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Both message printers begin by storing the addreus of the 
message into a page-zero inter. Then a subroutine named 

GET .NEXT.CHAR in lines 1680-1750 is called to pick up 
characters of the message. Since the last instruction in this 
subroutine is the one which picks up the character, the 
zero-status will be set if the $00 byte indicating 
end-of-message is picked up. 


What is in the Message? 


The real intelligence of my message printers is in the 
subroutine PUT.CHAR, starting at line 1760. We have already 
mentioned that a $00 byte indicates end-of-message. PUT.CHAR 
expects the X-register to contain a repeat count, and the 
A-register to contain the character to be printed. If the byte 
in the A-register has a value between $40 and SFF, it is sent 
‘to COUT to be printed (X) times. However, if the byte in the 
A-register has a value between $01 and $3F, it is interpreted 
in special way. 


Values between $80 and S9F are control characters, and will be 
interpreted by the monitor firmware. If you are in an 
80-column //e, //c, or //gs, the interpretation will be as 
shown in lines 1850-2070. In 40-column mode not all of the 
functions are active. A Viewmaster or other type of 80-column 
card will have its own set of controls. 


Values between $01 and $18 are interpreted by PUT.CHAR as the 
first byte of a two-byte cursor position code. This first byte 
indicates the line number (1-24 decimal) to put the cursor on, 
and the following byte is the column number (0-79 decimal). I 
defined a macro "POS" in lines 2100-2130 to simplify putting 
position codes into messages. 


Values between $19 and $3F are used to index a special function 
table. My table is shown in lines 2700-2840. Notice that I 
used a macro “FUN" to write each entry in the table. This 
macro defines the special function code as “F.name"*, and 
assembles the address-l of the code which performs the 
function. I thought of seven handy functions, but you can 
probably think of a lot more. As you do, just add >FUN lines 
to the table and write subroutines to perform the functions. 
Use mine as models, and you should be successful. 


The methods I used for setting up the cursor position and 
handling other special functions work with Apple's firmware in 
the 40- and 80-column modes; if you have a Viewmaster or other 
80-column card, you will need to make some changes in PUT.CHAR 
and its subroutines. 


I made macros for the all of the functions, shown in lines 
2140-2460. You might also find it handy to define macros for 
some of the control-characters processed by the 80-column 
firmware, but I didn't do it here. 


Even though I have the "POS" function for positioning the 


cursor on the screen, I still wanted the ability to do HTAB and 
VTAB independently. These are my first two functions. By 
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writing ">HTAB xx" you can position to column xx on the current 
line. “>VTAB yy” will put the cursor on line yy without 
changing the column. Again, yy is a number between 1 and 24, 
and xx runs from 0 to 79 (decimal). 


If you remember, normal characters are printed N times 
according to the value in the X-register when you call 
PUT.CHAR. The REP function lets you set up the repeat count. 
">REP n,char“ will cause char to be printed n times. 


The CEN funtion is perhaps the most powerful one. It centers a 
string on the current line. You simply write something like 


>CEN “This string will be centered" 


eeeand it will be. The code for this function is in lines 
3020-3180. All characters which follow the CEN function code 
are counted, up to the next function code or control character. 
Then the position for the first character is computed by 
halving the difference between window width and string length, 
and an HTAB performed. 


FIL and FCL will fill an entire line with a specified 
Character. FIL lets you say which line, and FCL fills the 
current line. You could do the same thing by putting the 
cursor at the beginning of the line to be filled and then using 
a repeat count larger than the window width followed by the 
fill character, but this way is easier. Let the computer work 
for you! 


WIN lets you specify a window on the screen. This is very 
rudimentary aS window routines go, because all it does is load 
the four locations the monitor uses to define the window: 
left, width, top, and bottom. “Left" is the column number to 
start the window at, and is a value from 0 to 79. “Width" is 
the number of characters in a line, and has a value from 1 to 
80. Just be sure that these two numbers do not add to a value 
greater than 80, unless you really want to clobber your 
program. "Top" is the line number of the top of the window, 
having a value from 0 to 23. “Bottom” is the line number of 
the bottom line of the window, plus 1; the value goes from 1 to 
24. The full 80-column window would be set up with “>WIN 
0,80,0,24". 


How about some examples? 


I wrote two sample programs. "T", in lines 3500-3540, calls 
MESSAGE.PRINTER to print the messages in lines 3560-3790. 
"TT", in lines 3950-4170, calls ANOTHER.MESSAGE.PRINTER to 
print embedded messages. 


1010 SSAVE S-C.MSG. MACHINE 
20- 1030 MON ccEFT EG 420 
21- 1080 MON.WIDTH .EQ $21 
22- 1050 MON - TOP EQ $22 
23- 1060 MON.BOTTOM .EQ $2 
oh - 1070 MON . CR "EQ $2 
25- 1080 ¥ MON {CV "EQ $25 
057B- 1100 MON.CH8O EQ $57B 
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DOS Anatomy 


AN UNPRECEDENTED DISASSEMBLY 


FEATURES: 


~- ONLY COMPLETE DISSASSEMBLY of the DOS 3.3 operating system, 

- entire operating system Is described In BOTH LINEAR AND FORMATTED FORMS. 

- all disassemblles are HEAVILY COMMENTED. 

- describes numerous tips and techniques for modifying DOS and Implementing 
sophisticated PROTECTION SCHEMES, 

- describes a LEGAL SOURCE OF FREE COMPUTER PAPER that may be located In your 
area, 

- Includes a UNIQUE TEXT-FILE READING PROGRAM (called TEXT READER) that can be 
used to read both random-access and sequential text files at binary speeds, 
This machIine-language program Is LOADED WITH OPTIONS and can be configured 
to accommodate various printers and interface cards. (Source code for the 
TEXT READER program Is available at an additional cost), 

- entire software package |s UNPROTECTED AND GUARANTEED. 

- high quality / low price: 64 FILES ON 15 DOUBLE-SIDED DISKS 

FOR ONLY $100 (US Funds). 


DESIGNED FOR: 


- software developers - computer magazine authors ~ protection artists 

- computer hackers - Instructors of assembly language 

- any assembly language programmer who frequently foregoes sleep In an effort 
to reach new plateaus of understanding, 


SYSTEM REQUIREMENTS = 


1) Apple 11+ (with 16K ram card), Apple ile or Apple tic. 

2) One disk drive (using 5-1/4 Inch diskettes), 

3) OOS 3.3 operating system, (Note: In order to conserve disk space, al! 
flles are housed on DOS-less data disks, Therefore, you must boot with a 
normal version of DOS 3.3 before this software package can be used.) 

4) Printer that can support a 132-character IIine length In condensed or normal 
modes, (A smaller printer width can be used but Is not recommended,) 

---Optional-— 

5) MERLIN (a.k.a. "BIG MAC") assembler. (An assembler Is not required If you 
just wish to review the text file contents, Text files containing numerical 
and aiphabetical cross-referenced symbo! tables are provided to assist 
programmers who own a different brand of assembler.) 

6) The book "BENEATH APPLE DOS" would prove helpful, 


To order, send cheque or money order for $100 (US Funds) to: 
WINDSOR SCIENTIFIC LTD. 
3621 = 109 Avenue Edmonton Alberta 
Canada T5W OG6 
Phone (403) 479-2779 


DOS 3.3, MERLIN and BENEATH APPLE DOS ere respective trademarks or products of Apple Computer Inc., 
Royer Wagner Publishing Inc. and Quality Softwere,. 
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FC22= 1120 MON.VTAB ~-EQ $FC22 
FDED- 486 MON . COUT ~EQ $FDED 
00- 1130 MSG.PNTR .EQ $00,01 
ike # Address of message in Y,A registers 
1190 -MA MSG MSG <message address> 
1200 LDA #]1 
1210 LDY /Jj1 
‘Sa0 JSR MESSAGE. PRINTER 
|: ne 
\een MESSAGE. PRINTER 
0800- § 00 1260 STA MSG. PNTR Store message address 
0802- 84 01 it STY MSG. PNTR+1 into page-zero pointer 
aeons a ec ~ Save X-register 
O806- A2 01 1390 LDX #1 Clear repetition counter 
O808- 20 3F 08 1310 JSR GET.CHAR First char of message 
O80B~ FO 08 1320 BEQ .2 »s empty message! 
O80D=- 20 44 08 1330 | JSR PUT.CHAR Process the character 
0810- 20 33 08 1340 JSR GET.NEXT.CHAR get another one 
0813- DO F 1350 BNE .1 ~»e-not at end of message yet 
pees ioe a2 ra Restore X-register 
0817= 60 Bt RTS Return to caller 
ee # Message follows JSR to message printer 
1420 ANOTHER.MESSAGE. PRINTER 
0818- 68 ee PLA Store message address (-1) 
Ores 8 00 Lb 2 a MSG. PNTR into page-zero pointer 
081C- 85 01 1420 STA MSG. PNTR+1 
ei Be —— 
cae nn ne! eae 
0822- A2 01 1510 LDX #1 Clear repetition counter 
O824- DO 3 1520 BNE .2 -- Always 
0826- 20 4 as 1336 | JSR PUT.CHAR Process a character 
0829- 2 33 08 1540 .2 JSR GET.NEXT.CHAR 
082C- DOF 1550 BNE .1 ~»-not at end of message yet 
eaeee + en ae Restore Y-register 
Op 30 a 1380 ae Restore X-register 
aeons he 01 ioe cn MSG. PNTR+1 Get return address back on stack 
08 35- i 00 ipee ay MSG. PNTR 
08 3b- 60 1640 : RTS Return to caller 
iene # Get a message character 
1650 GET .NEXT.CHAR 
0839- E6 0 1620 INC MSG.PNTR 
O83B- DO 02 1700 BNE GET.CHAR 
083D- E6 0 1710 INC MSG. PNTR+1 
1720 GET.CHAR 
083F- AO 00 ie LDY fr 
0841- B1 00 1740 LDA (MSG.PNTR),Y 
0843- 60 it20 P RTS 
Li # Process a message character 
1780 # 
vie # 00 END OF MESSAGE 
1800 # YY XX where is between $01 and le position 
1810 # the cursor as vtab ,» Htab XX. 
1820 # 213 -B8 special functions 
eR : iQ print as is 
1850 ® Characters between $80 and $9F are interpreted by 
Ua : the Apple 80-column firmware as follows: 
1850 # a7 bell 
arte # 8 backs pace 
1900 # 8A move cursor down one line 
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086 1- 
0862- 


ig 


60 


ae ee ee ee ee 
OWOOWOOMWWOWw 
OO CO~ QU FU) M0 
alelelelelolelelolo) 


# 8B clear from cursor to end of window 
# 8C clear window and home cursor 
# 8D carriage return 
# 8E normal video 
# 8F inverse video 
® 91 switch to 40-column 
& 92 switch to 80-column 
& 9 de-activate firmware 
& 9 scroll display down one line 
® 9 scroll display up one line 
# 9 disable Mouse Text 
ad 99 home cursor without clearing window 
# 9A clear current line 
® 9B enable Mouse Text 
# 9C move cursor forward one space 
& 9D clear to end of line 
: OF move cursor up one line 
Pr Message Content Macros 
MA 98 Position cursor (vtab, htab) 
DA #31, 
i . EM 
-MA R Repeat character N times 
DA F. PREP, #]i 3 J2 
P . EM 
~MA CEN Center a string on current line 
-DA #F.CE 
eAS -")1" 
. EM 
-MA STR normal Ascii string 
~AS -")1" 
P . EM 
-MA F Fill ppecstied line with character 
DA iF. “FIL, #]1, #"J2 
a . EM 
MA FCL Fill current line with character 
-DA #F.FCL,#"]1 
. —M 
Gee a eee ae ceeee 
-MA WIN new text window 
DA #F. WIN, #11 812, 13,814 
. - EM 
-MA H Htab the cursor 
DA iF ARTAB, #11 
- EM 
ae a ee eee ee eee 
-MA VTAB Vtab the cursor 
-DA #F.VTAB,#]1 
EM 
eae oN aR OS SE ENE TOY TP Oe 
PUT.CHAR 
CMP #310 IS IT PRINTABLE? 
BCC . ~e»NO, SPECIAL FUNCTION 
1 JSR MON .COUT 
DEX Decrement repeat count 
BNE .1 sce Tepent the character 
i” Put the repeat count back to 1 
#..~Process function char-~-------- 
-2 CMP #$19 >POS VV,HH or special function? 
BCC P.POS ~ee>POS call 
#~--Branch to function code------- 
Lae Double function # to make index 
CPY #FUN.TBL.SZ 
BCS eee illegal function 
LDA FUN. TBL+1 
PHA but t function code address-1 on stack 
LDA FUN.TBL,Y 
. PHA 
3 RTS Go to it! 
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When You Buy Your IIGs’ 


| Insist on GSRAM’ 


Expand the IIGs RAM and ROM with the GSRAM or GSRAM Plus 
with ROM Pak. Available now with 256K to 8 MEG! 


Rasaae the 16K cards for the II+ and 
; the 64K cards for the Ile? At the time, that 

| much memory seemed like a lot But when 
| 

| 


| 
| 


the owners of these memory cards came to 
us for more Memory, many had to throw 
away their smaller Apple memory cards or ty 
t© sell them. Most of our customers told us 
that had they known about Applied Engi- 
neering’s larger memory cards when they 
bought their Apple, they would have pur- 
chased them at the same ume. 

GSRAM and GSRAM Plus are available now, 
allowing up to 8 MEG of memory expansion. 
That's 8 times the memory capacity of 
Apple's card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 
Apple’s card: 

e Lower cost 

e Has 6 RAM banks (Apple's card has 4) 

e Has memory expansion port 

e Has ROM expansion port 

e No configuration blocks to set 

e No soldered in RAM chips 

e Expandable to 8 MEG 

e Expands AppleWorks intemal limits 

e Built-in Hi-Res self- diagnostic software 

i e 5 year hassle free warranty (Apple has a 90 
day warranty) 

e Made in USA 


| GSRAM for More 

. AppleWorks Power 

© Only GSRAM and GsRAM Plus climinate 

| AppleWorks intemal memory limits, increas: 
ing the maximum number of records avail- 
able from 6.000 to over 25,000 and only Gs 
RAM and GSRAM Plus increase the number 

| of lines permitted in the word processing 

| mode from 6,000 to over 15,000. And only 

~ GSRAM and GSRAM Plas offer a builtin 
printer buffer so vou can continuc: using 
Appleworks while vour printer is printing, Gs 
RAM and GSRAM Plus even expand the 
number of lines in the dipboard from 255 to 
2047 and will auto segment large files so they 
can be saved on avo or more clisks. You can 


even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GSRAM Plus will even 
display the time and date right on the 
AppleWorks screen. Nothing comes dose to 
enhancing AppleWorks so much. 
Turn Your IlIcs into a Giant 
Simpl plug GSRAM into the IIGs memory 

expansion slot and you've got up to 8 mega- 
bytes of RAM at your fingertips—all of it 
instantly and automatically recognized by the 
IIGs. GSRAM is compatible with all Ics 
software, including AppleWorks, as well as 

' BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 
Grow by Bytes or Megabytes 


We offer GSRAM in two configurations so 
you can increase your memory 256K at a 
ume (GSRAM) or a megabyte at a time (GS- 
RAM Plus). Both offer full compatibility, lower 
cost than other boards, and easy expandabil- 
ity. And both are excemely low in power 
consumption. A fully expanded GsRAM oper- 
ates at onl: 375 ma, and GSRAM Plus at only 
270 ma (even with 6 megabytes on board!) 
GSRAM—for Normal 
Memory Requirements 

GSRAM is available with 256K, 512K, 1 
MEG or 1.5 MEG of memory already on 
board. If you don’t need the full 1.5 MEG 
now, you can choose a GSRAM with less 
memory and expand it up to 1.5 MEG in the 
furure-——or upgrade to GSRAM Plus for a 
j small charge. 


“In quality: 
Performance. 
compatibility. 
expandability and 
support, Applied 
Engineerthe's GSRAM 
anid GSRAM Plus are 
number one.” 


|| Steve Wozniak, the creator 
| of Apple Computer 


With an optional piggyback card, you can 
expand GSRAM even higher than 1.5 MEG! 
(Other cards are only expandable to 1 MEG.) 
GSRAM Plus—for Growing 
by Leaps and Bounds 

GSRAM Plus is the first Apple memory card to 
use 1 MEG RAM chips on the main board 
Its available with 1 t0 6 MEG on board. If 
you don’t need the whole 6 MEG now, you 
can buy a GSRAM Plus with less memory and 
easily expand it in the future. 

GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card. 

Easy Expansion 

Both GsRAM and GsRAM Plus use standard 
RAM chips that are readily available and just 
plug right in. So unlike other cards, you'll find 
expanding your GSRAM or GSRAM Plus easy, 
convenient and very economical And with 
our Optional ROM expansion module you 
can even increase the IGs'’s ROM space and 
all in just one slot 
Quality and Support of the 
Industry Leader 

Applied Engineering is the largest supplier 
of Apple peripherals in the world We 
invented the first large RAM cards for the 
Apple. With a 5-vear “no-hassle” warranty and 
outstanding technical support, you can be 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for—or retum 
them within 15 days for a full refund. 


GSRAM with 256K 
GSRAM with 512K 
GSRAM with 1 MEG 
GSRAM with 1.5 MEG 


GSRAM with 2-8 MEG 


GSRAM PLUS with 1 MEG 
GSRAM PLUS with 2 MEG 
GSRAM PLUS with 3-8 MEG 


Order today! 

See your dealer or call Applied Engineering 
today, 9 am to 1] pm 7 days Or send 
check or money order to Applied Engineer- 
ing, MasterCard, VISA and CO.D. welcome. 
Texas residents add 6'4% sles tax. Add $10.00 
outside USA 


JAE APPLIED ENGINEERING” 
The Apple enhancement experts. 
(214) 241-6060 


P.O. Box 798, Carrollton. TX 75006 


es eS EE 


CP Mos a registered trademark of Digital Research. Ine 
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MA FUN 
2710 F.]1 -EQ #-FUN.TBL/2 


2720 -DA P.J1-1 

Ant - EM 
0831 S160 FUN.TBL EQ *-$19-319 
O86 - 2760 FUN VTAB Vtab YY 
0865- 2770 >FUN HTAB Htab XX 
0867- 2780 >FUN REP Repeat, count, character 
0869- 2790 >FUN CEN Center, string, null 
086B- 2800 >FUN NUL -..ends centered string 
086D- 2810 >FUN FIL Fill, line #, char 
O86F- 2820 >FUN FCL Fill current line, char 
0871- 2830 FUN WIN Window, left, width, top, bottom 
ea 20 BC 08 2860 P.POS JSR MY.VTAB Do vertical tab 
0876- 20 39 08 2870 P.HTAB JSR GET.NEXT.CHAR ...get horoz value 
0879- C5 21 2880 CMP MON .WIDTH Stay inside current window 
087B- 90 O4 2890 BCC .1 e-e-it is inside 
O87D- A5 21 2900 LDA MON .WIDTH --e-use right edge 
O87F- ES 01 2910 SBC #1 
0881- 85 24 2920 .1 STA MON.CH 40-column horiz pos'n 
0883- 8D 7B 05 2930 STA MON.CH80 80-column horiz pos'n 
0886- 60 29 40 RTS 

2950 @------------3-~--+-2--2-<-2s-5-- 
0887- 20 39 08 2960 P.REP JSR GET.NEXT.CHAR 
O88A— AA 2970 TAX REPETITION COUNT 
O8BB- 60 29 30 RTS 

2990 SB mmw ww nen ewww wwe enw ene ee eee 

3040 # Center a string on current line 
O88C- AO 00 3020 P.CEN LDY #0 Count # chars in string 
O88E- C8 3030 .1 INY from next char to char below $40 
O88F- B1 00 3040 LDA eG sENTR? Y or btwn $80 and $9F 
0891- 30 O4 050 BMI .2 }-FF 
08 33- C9 40 060 CMP ete 
0895- BO F 070 BCS . 40-7F, keep counting 
0897- C9 A 080 .2 CMP ea 
089 - BO F3 090 BCS . AO-FF, keep counting 
O89B- 88 100 DEY 00-3F or 80-9F, end of strin 
089cC- 28 3110 TYA (Line.width - string.len) / 
089D- 3 FF 3120 EOR #$FF gives starting horiz posn 
O89F- 3 3130 SEC 
O8A0=- 65 21 3 0 ADC MON .WIDTH 
O8A2— NA 150 LSR 
O8A3- 85 24h 3160 STA MON .CH 
O8A5- 8D 7B 05 athe STA MON .CH80 
O8A8= 60 3150 P.NUL RTS 
O8A9- 20 39 08 3200 P.FIL JSR GET.NEXT.CHAR 
O8AC- 20 BC 08 3210 JSR MY.VTAB 

220 P.FCL 
O8AF- AQ 00 3230 LDA #0 
O8B1=- 85 24 3240 STA MON.CH 
O8B3- 8D 7B 05 3250 STA MON .CH80 
O8Bo—- A6 21 260 LDX MON .WIDTH 
O8B8- 60 : : . RTS 
O8B9- 20 39 08 3290 P.VTAB JSR GET.NEXT.CHAR 

00 MY.VTAB 

O8BC- C5 23 10 CMP MON .BOTTOM Stay inside current window 
O8BE- 90 02 3320 BCC .1 --e-lt is inside 
O8CO- A5 23 3370 LDA MON .BOTTOM Go to bottom line 
O8C2=- 85 2 3340 .1 STA MON .CV We use line # 1 to N, but 
O8CH=- C6 25 3350 DEC MON.CV monitor uses 0 to Ne-1 
O08C6—= 4C 22 FC 3360 JMP MON .VTAB 

3316 ee 

3380 P.WIN 
08C9=- 20 39 08 3330 JSR GET.NEXT.CHAR 
O8CC=- 85 20 3400 STA MON .LEFT 
O8CE- 20 39 08 3410 JSR GET.NEXT.CHAR 
O8D1=- 85 21 3420 STA MON .WIDTH 
O8D3= 20 39 08 3730 JSR GET.NEXT.CHAR 
O8D6- 85 22 3440 STA MON .TOP 
O8D8=- 20 39 08 3450 JSR GET.NEXT.CHAR 
O8DB- 85 23 3100 STA MON .BOTTOM 
O8DD- AS 99 ane LDA #$99 
O8DF- 4C ED FD 3480 JMP MON .COUT 
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17 Meg lie/1Meglic 


Want the best & easiest-to-use (most support) RAM card on 
the market — at the best price? Buy Checkmate Technology’s 
State-Of-The-Art MULTIRAM RGB RAM CARD™ from us 
w/BATTERY BACKED-UP RAM options that save pro- 
grams like AppleWorks for years! FAST CHEAP RE- 
PLACEMENT FOR HARD DISKS, USER EXPANDABLE 
TO 17 MEGS, (100%) compatible w/all 3rd party software/ 
hardware, 65C816 option ($147), sharp 80 columns/Double 
Hi-Res, & FREE RGB! Direct substitute for Ramworks I-III" 
(we think it’s better) by Applied Engineering (also known as 
Preferred Computing) or Apple 80 col cards, has a 5 YR 
WARRANTY, 15 day money back guarantee, & FREE 
AUTOMATIC SOFTWARE UPDATES ONLY FROM US! 


MultiRam RGB expands to 1 Meg + optional BATTERY 
PROTECTABLE MultiRam Pius piggyback expandable to 
16 Meg’s. MultiRam tle expands to 768k. The software & 
manual is the best & easiest-to-use on the market — without 
exception! 


FREE APPLEWORKS EXPANDER SOFTWARE W/EVERY 
CARD — loads ALL versions of Appleworks (in 30 seconds w/ 
AW 2.0), even printer routines, runs faster, Desktop 2048k, 
23,000+ records & 4,800+ word proc lines, segments lg files 
onto multiple disks! FREE AW TIME/DAY/DATE ON-SCREEN 
w/ clock, AUTO-COPY TO RAM, PRODOS/DOS 3.3. RAM 
DISK & TEST. Optional CP/M & Pascal Ram disks ($20/ea)! 


MultiRam MultiRam 
RGB Card ile Card 
129. 
157. 
187. 
212. 
-*® & & © 
MultiRam 
Pius Piggyback 
MultiRamPlus ... 219. ... 
MuiltiRamPlius ... 269. ... 
MultiRamPlus ... 316. ... 
1024k MultiRamPlus ... 359. ... 
2-17 meg MultiRamPlus ... Call 
Battery/AC Kit (for Plus) ... 36.... 


64k 
320k 
576k 
832k 
1024k 


MultiRam 
MultiRam 
MultiRam 
MultiRam 
MultiRam 


NEW 
NEW 
NEW 
NEW 
NEW 
NEW 


256k 
512k 
768k 


WHY BUY FROM COIT VALLEY COMPU- 
TERS RATHER THAN SOME MAIL ORDER 
HOUSES? Only we offer a 15 day MultiRam 
complete money back satisfaction guaran- 
tee, extra software, more support, free auto- 
matic software updates, free 64k w/ each 
256k/51 2k/768k lle/RGB card. We know the 
products, & stock them for fast shipping! CALL 
FOR SUPPORT, QUESTIONS, PRICES, DIS- 
COUNTS. SCHOOLS & GROUPS WELCOME. 


COIT VALLEY COMPUTERS 
(214) 234-5047 
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Checkmate Technology’s MultiRam CX card easily ex- 
pands your lic to 640k and has a CX+ Piggyback to add 
another 512k (1152k total)! It’s 100% compatible with all lic 
software/hardware & upgradable with a 65C816 kit ($95) — 
all at about 50% less power than Z-RAM"™! Has the SAME 
FREE SOFTWARE/UPDATES & 5 YR WARRANTY AS lle 
CARDS. Buy a C-VUE flat panel display for $287 w/ 512k 
or greater card. 


256k MULTIRAM CX 

512k MULTIRAM CX 

768k MULTIRAM CX Combo 
1024k MULTIRAM CX Combo 


256k MULTIRAM CX+ 
512k MULTIRAM CX+ 


1200 Baud lic Modem (add $20 for cable) . 147. 
Clip-on lic Rechargable Battery 

lic Flat Panel Display (w/ 512k > Mram) .... 

lic System Clock 


Cermetek 1200 internal modem Ile/l+-/Algs . 148. 
(+ FREE Source subscription/ VT 100 Shareware/ 
ASCIl Express & ProTERM™ Setup Instructions) 


Siot 1-7 Ram Card for fl+, ile, Laser 

ProAPP 20 Meg Hard Disks (+ FREE software) ... 
Apple ile Enhancement Kit 

Apple ligs 

Apple 3.5 800k Unidrive (lle/lic/ligs) 

Super Serial Compatible Card 

RamPak 512k gs RAM card 

Apple Compatible Drive lle/ll+ (Iigs/lic + $19) ... 
Clockworks Clock (Thunder/Time HO™ compat) .... 
13” RGB Monitor w/ cables (req. RGB card) 
Heavy Duty Power Supply II/li+/lle 

lle Programmable Numeric Keypad 

System Saver Fan (II/Il+ /Ile) 

Uninterruptable Power Supply 250 watt 


AutoWorks (Best AW Macro + more) 

FontWorks (Best AW sideways/Fonts & more) .... 
Pinpoint Program 

Pinpoint Document Checker (Best Spellier) 

Copy ll Pius 7.3 (Best ProDOS Utility) 

ProTERM Modem Software 

ASCll Express Modem Software 

VIP Professional (Lotus Clone. Specify Comp) ... 


Terms: Add $4-Ground or $6-Air shipping & phone # toeach U.S. 
MultiRam card order (foreign orders/FPO/APO extra). Add 3% for 
MasterCard/Visa/Am Exp (include expir date) & P.O.’s. For fast 
delivery send Cashier’s/Certified check/Money Order. C.O.D. 
(add $5) & personal checks accepted (allow 16 days). Tex res add 
7 %4% tax. Software non-returnable. 

Ordering: PRINT Name & address, Res & Bus phone, credit card 
name/number/expir date where appropriate, qty/description/ 
price/shipping charges if known. Cail for questions. 


Autoworks. Ramworks Hl/Timemaster |] H.O./Z-ram, respective trademarks otf Software Touch, Applied 
Engineenng. Prices subject to change. 


14055 Waterfall Way 
Dallas, Texas 75240 


NGO. Beeese eee eee bee eee leew celes 
O8E2- 500 T >MSG MSGO 


O8E9- 510 >MSG MSG2 
O8F0- 520 >MSG MSG1 
O8F7- 3530 >MSG MSG3 
O8FE- 60 32 0 : RTS 
O8FF- 8C 560 MSGO ~HS 8C HOME SCREEN 
0900- 570 >WIN 10,38,0,24 
0905- 580 »FIL 1,- FILL TOP LINE WITH DASHES 
0908- FC 590 ~HS FC ONE BAR ON NEXT LINE 
0909- 8D 88 FC 
090C- FC 3600 -HS 8D.88.FC.FC 2 BARS 
090D- 8D 88 FC 
0910—- FC 3610 -HS 8D.88.FC.FC 2 BARS 
0911- 8D 88 FC 
0914— FC 3620 -HS 8D.88.FC.FC 2 BARS 
0915=- 8D 88 FC 
09138— FC 36 30 ~HS 8D.88.FC.FC 2 BARS 
0919- 8D 88 FC 
091C=- FC 3640 ~HS 8D.88.FC.FC 2 BARS 
091D=- 8D 88 FC 
0920- FC 3650 ~HS 8D.88.FC.FC 2 BARS 
0921- 8D 88 FC 3660 -HS 8D.88.FC 1 BAR AT END OF LINE 
0924- 3670 >FCL <= FULL CURRENT LINE WITH DASHES 
0926- 30 0 >POS 3,0 VTAB 3, HTAB 0 
0928- 8F 690 HS 8F INVERSE MODE 
0929- 3700 >CEN "Demonstration of Message Printer® 
O9HNA- 8E 8D 8D 3710 ~HS 8E.8D.8D Normal mode 
O94D- 720 SCEN "S-C Software Corporation" 
0966- 8D 730 -HS 8D 
0967- 3740 >CEN "P, 0. Box 280300" 
0978- 8D 3750 ~HS 8D 
0979- 3760 >CEN "Dallas, TX 75228" 
O98A- 8D 8D 8D 3770 ~HS 8D.8D.8D 
098D- 3780 WIN 0, 80, 0,24 Full screen again 
0992=- 00 ; a0 , ~HS 00 End of message 
0993- 810 MSG1 >POS 11,1 VTAB 11, HTAB 1 
0995- 9D 3820 -HS 9D CLR EOL 
0996- 3830 >»STR "SELECT ONE: "* 
O9A3- 00 i890 : ~HS 00 End of message 
O9A4- 860 MSG2 »>POS 24,1 VTAB 24, HTAB 1 
O9A6- 8F 3870 ~HS 8F INVERSE MODE’ 
O9AT- 880 SSTR " <SPACE> FOR MENU eee FOR MORE * 
O9CC- 8E 00 3890 : .HS 8E.00 NORMAL MODE, 
O9CE- 87 87 8D 3349 MSG3 ~HS a -87.8D 
O9D1- 920 ur aoe that a nice demonstration?®" 
O9F2- 8D 00 ttt i 
O9F4- 20 18 08 3320 TT JSR ANOTHER.MESSAGE. PRINTER 
O9F7- 8D &D 960 ~HS 8D.8D 
O9F9- 3376 SCEN "This is another way to print messages." 
OA20- 3980 >HTAB 0 
OA22— 332° >STR "<<<8 
OA25- 00 >HTAB 92 TAB TO END OF LINE 
OA2T- 88 88 4010 ~-HS 88.88 BACK UP TWO SPACES 
OA29- 4020 >STR ">>>" 
OQA2C- 8D 00 4030 HS 8D.00 
OA2E- 20 18 08 4040 JSR ANOTHER .MESSAGE. PRINTER 
0OA31~ 4050 >REP 10 M-$40 10 CARRIAGE RETURNS 
OA34- 4060 SWIN 0,1,14,24 
OA39—- 4070 >REP ; 
0A3C- 4080 >WIN 79,1, 14,24 
OA41—- 4090 >REP 
OANK- 4100 YWIN 0,80,13,24 
OANO- 4110 >FCL _ 
OANB- 4120 >FIL 23,- 
OANE- 4130 >WIN 0,80,0,24 
0A53- 4140 >VTAB 34 
0A55- 00 4150 HS 00 End of message 
0A56- 60 4160 
W170 8 nn een een ne eee ew eee 
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Revision to DOS 3.3 for UniDisk D496 kh Gee ae ae eee eee LE Morgan 


Since we published my patches to allow DOS 3.3 to use the 
UniDisk 3.5 last May and June I've been using it every day, and 


just loving all that space. 


After basking in readers' praise 


for such a useful piece of code, you can imagine how I felt 
when I first went to boot that disk on the IIgs and watched it 


crash into the 


After a little detective work the cause is found: 


dirt! 


When we boot 


from the //e Protocol Converter Interface it passes slot*l6 in 


the A- and X-registers and the slot number in location $58. 


In 


my boot code in FORMAT.UNIDISK I was using the A-register and 


the contents of $58 to set up my RWTS. 


Come to find out, the 


IIgs only gives us the slot*l6 in the X-register, so we have to 
do a little more manipulation to create the values we need. 
Here is the revised code: 


3080 
3082 
3090 
3092 
3094 
3096 


BOOT TXA 
PHA 
LSR 
LSR 
LSR 


LSR 


save slot*1l6 
~divide 

~e-by 16 

eee tO get 
eee Slot 


To update the boot image on an existing disk you can use the 


instructions at the top of page 23 of the July '86 issue. 


Be 


Sure to note the caution in the last paragraph of page 21 in 
that issue, about not installing a DOS image that already 


contains RAMdi 


12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 
All new 1984 design incorporates the 
latest in state-of-art 1.C. technologies. 
Complete 12 bit A/D converter, with an 
accuracy of 0.02%! 


16 single ended channels (single ended 
means that your signals are measured 
against the Apple's GND.) or 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

9 software programmable full scale 
ranges. any of the 16 channels can have 
any fange at any tine. Under program 
control, you can select any of the 
following ranges: + 10 volts, t SV. 
+2.5V, t1.0V, + SOOMV. + 250MV, 
t1IOUMV, tSOMV or 4 25MV. 

Very last conversion (2§ micro seconds). 
Analog input resistance greater than 
1,000,000 ohms. 

Laser-trimmed scaling resistors. 

Low power consumption through the 
use of CMOS devices. 

The user connector has +12 and -12 
volts on it so you Can power your 
sensors. 

Only elementary programming is 
required to use the A/D. 

The entire system ty On one standard 
size plug in card that fits neatly inside 
the Apple. 

System includes sample programs on 


oss PRICE $319 
A few applications may include the moni 
tonng of @ flow @ temperature @ humid: 
ty @ wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ soil mors- 
ture and many more 


sk patches: 


We Make Measurement And Control Easy! 


A/D & D/A 
A/D & D/A Features: 
@ Single PC card 
@ 8 channels A/D 
@ 8 channels D/A 
@ Superfast conversion time 
@ Very easy programming 
@ Many analog ranges 
@ Manual contains sample applications 


A/D SPECIFICATIONS 

@ 0.3% accuracy 
@ On-board memory 
@ Fast conversion (078 MS per channel) 
@ A/D process totally transparent to 

Apple (looks like memory) 
@ User programmable input ranges are 

Oto 10 volts,0to5, Sto+5, -2.5 

to +2.5, -5 100, -10 WO. 
The A/D process lakes place on a Continuous, 
channel sequencing basis. Data is automatic- 
ally transferred to its proper location in the 
un- board RAM. No A/D converter could be 
easier to use. 


D/A SPECIFICATIONS 

@ 0.3% accuracy 
@ On-board memory 
@ On-board output buffer amps can 

drive 5 MA 
@ D/A process is totally transparent to 

the Apple (just poke the data) 
@ Fast conversion (003 MS per channel) 
@ User programmable output ranges are 

0 to § volts and 0 to 10 volts 
The D/A section contains 8 digital to analog 
converters, with oulput bulfer amplifiers and 
all interface logic on a single card. On-card 
lat hes are provided for each of the eight 
D/A converters. No 0/A converter could be 
casier to use The on-board amplitters are 
laser-trmmed during manufacture, thereby 
eliminating any requirement for off-set 


nulling PRICE $199 


@ Provides 4, 8-Bit programmable |/O 


@ Any of the 4 ports can be pro 


@ All 1/O lines are TTL (0-5 voit) 


I tripped over that again myself! 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is designed ior use with both our A/D converters. This 
board incorporates 8 FET. op-amps, which aliow almost any gain or offset. For example, 
an inpul signal that varies from 2.00 to 2.15 volts or a signal that varies from 0 to 50 
mV can easily be converted to 0-10V output far the A/D. 


The signal conditioners outputs are on 2 high quality 16 pin gold 1.C. socket that 
matches the ane on the A/D’s soa simple nthun cable connects the two. The signal 
conditioner can be powered by your Apple ur trom an external supply. 


FEATURES 
@ 4.5” square for standard card cage and 4 mounting holes tor standard mounting The 


signal conditioner does not plug into the Appice it can be loc ated up to mile away from 
the A/D. 


@ 22 pin.156 spacing edge card input connector (extra Connectors are easily available i.e. 


Radw Shack). 


@ Large bread board area. 
@ Full detailed schematic included. 


PRICE $79 


(/O 32 


@ Your inputs can be anything from 
Ports high speed logic to simple switches 


@ Programming is made very easy by 

grammed as an input or an output powerlul on-board firmware 

port 

@ The I/O 32 is your best choice for any 
control application 


compatible 


The !/O manual includes many programs for inputs and outputs. 


Some applications include: 
Burylar alarm, direc tion sensing use with relays to tusa on lights, sound buzzers, start 
motors, control tape recorders and printers, use with digital joystick 


PRICE $89 


Please see our other tull page ad in this magazine for ifermgion oo Applied Cagmeenog s Timemaster Clock Card and other products for the Apple. 


Our boards are far superior to most of the Consumer electronics made today ALLL ¢ 


‘sate nt high quality sockets with milespec. Components used throughout. PC boards are glass epoxy 


with gold contacts, Made in Ametica to be the bestin the world. All products compatible with Apple Wand //e 
Apphed Enginecanyg'’s products are fully tested with complete documentaton aad available for mmediate delivery All products are guaranteed with a no hassle three year warranty. 


Texas Residents Add 5% Sales Tax 
Add $10.00 If Outside U.S.A. 


Send Check of Money Order tu. 
APPLIED ENGINEERING 
P.O. Box 798 
Carrollton, TX 75006 


Call (214)241-6060 
9am. toll pm 7 days a week 
MasterCard, Visa & C.O D. Welcome 
No extra charge for credit cards 
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A PER-fect Tool for 65816 Position-Independent Code 
ecocceeeeee candy Mossberg 


Digging into the 65816 Apple IIgs has provided more entertain- 
ment than I've had since the introduction of the Apple II. So 
far, my programming efforts have been in the ProDos 8 
environment. When Apple gets its act together on ProDOS 16, 
writing position-independent code will become critical. Why 
not do a bit of preparing now? (The following techniques will 
apply to older Apples which have been upgraded with a 65802 cpu 
chip, also.) 


Absolute internal references are the bugaboo of the position- 
independent programmer. (By the way, I am not referring to 
those individuals who program as well standing on their heads 
as they do flat on their backs or seated in a chair; I am 
referring to programs which run correctly no matter where they 
are loaded into memory, without any modifications to reflect 
the position in memory.) The three most common absolute 
internal references are: 


) the JMP to a program location; 

) the JSR to a subroutine location; and 

) the -reading from or writing to program 
text or data tables or variables. 


The first problem can be solved simply by using the BRL 
instruction instead of JMP. For avoiding the second and third 
traps, the PER opcode is an ideal tool. The solutions outlined 
below pertain only to code and data within one 64K bank of 
memory. Solutions which handle programs and data in multiple 
banks will have to wait for future articles. 


PER is one of the new opcodes found in the 65802 and 65816. 

PER stands for “Push Effective program counter (PC) Relative 
data word onto stack", and employs a hybrid stack/PC-relative 
addressing mode. PER adds the 16-bit signed displacement in 
its two-byte operand to the current value for the PC and pushes 
the result onto the stack. As usual, the high byte is pushed 
first, then the low byte. Regardless of the values for the m-, 
x-, and e-status bits, two bytes are always pushed onto the 
stack. Because the operand is a displacement relative to the 
PC, the top two bytes of the stack always will point to the 
Gesignated program code or data, irrespective of whether it is 
internal or external to the program. Thus, an internal JSR can 
be simulated by the following sequence: 


PER CONTINUE-1 
BRA SUBROUTINE 
CONTINUE ... 


SUBROUTINE ... 


RTS 


Note that the continuation address to be placed on the stack 
must be one less than the desired address (CONTINUE-1 above), 
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because the RTS opcode increments the address it finds on the 
stack before jumping to that address. Also note that the BRA 
opcode works well if the subroutine is nearby (within about + 
Or - 128 bytes of the BRA itself); if the subroutine is further 
away, you will need to use the BRL opcode here. 


I have constructed two macros in the listing of the program 
which follows. >BSR calls nearby subroutines, and >BSL calls 
both nearby and distant subroutines. The macro definitions are 
in lines 1130-1210, and I have shown them in use in lines 
1320-1330. The listed program itself is rather trivial, 
designed just to illustrate my contrived solutions. Lines 
1270-1340 clear the screen and then print out the hex values 
from $00 to SFO, with an interval of $10. The two loops in 
lines 1350-1560 show two different ways to access data which is 
part of a program and still be position-independent; their 
function is to print out a string. 


To access internal data, PER again comes to the rescue by 
allowing us to establish an external (zero page or stack) 
pointer to the data. Here, the operand must represent the 
exact address of the target data. The first example stores the 
pointer generated by PER into a pointer-variable in page zero 
(lines 1360-1400). PER puts the pointer onto the stack, and 
two PLAS pull it back off. If we were in Native mode with the 
m-bit cleared for 16-bit operation, only one PLA and STA would 
be needed. We could replace lines 1370-1400 with: 


CLC 

XCE ENTER NATIVE MODE 

REP #$20 M=0, 16-BIT DATA 

PLA PULL OFF BOTH BYTES 
STA PTR STORE BOTH BYTES 

XCE BACK TO EMULATION MODE 


The second approach is to leave the REP-generated pointer on 
the stack. Line 1500 shows how we can use it with stack- 
relative indirect-indexed address mode to access the same text 
string. Lines 1550 and 1560 are then absolutely necessary, to 
remove the pointer from the stack when we are finished with it. 


Though it is not appropriate for this sample program, the power 
of native mode is evident when working with 16-bit address 
pointers. The problem of using native mode in simple examples 
is that you cannot call the old standard monitor entry points 
(such as HOME, COUT, and PRBYTE) from native mode. 


If you are going to write code which will be crossing 64K 
banks, you can still use the PER instruction. However, you 
also have to take into account the program bank and data bank 
registers. More on this at another time. 


1898 GOAVE S.POSITION Se 
1050 POSITION INDEPENDENT CODE WITH THE 65802/16 
1040 -OP 65816 
1050 #--2------ enn nn nn enon nee 
06- 1060 NUM ~EQ the 
OT- 1070 PTR EQ $07,08 
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RamWorks III 


Patented Performance from the Recognized Leader 


With battery backed RAM port RGB port increased memory capacity, full software 
compatibility and more compact design, RamWorks III is a generation ahead 


RamWorks II is the newest 3rd 
generation RAM card for the Apple Ile. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease Of use. A design so advanced it’s 
patented. We call it RamWorks HL you'll 
call it awesome! 


The AppleWorks Amplifier. 
While RamWorks III is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you'd expect RamWorks HI to 
expand the available desktop, after all 


Applied Engineering was a year ahead of 


everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and only RamWorks Il 
does. With a 256K or larger RamWorks 
IL, all of AppleWorks (induding printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 


Ny 


Only RamWorks eliminates Apple- 
Works’ intemal memory limits, increasing 
the maximum number of records avail- 
able from 1,350 to over 25,000. Onh) 
RamWorks increases the number of lines 
permitted in the word processing mode 


| from 2,250 to over 15,000. And orth: 
RamWorks offers a built-in printer buffer, | 


sO you won't have to wait for your 
printer to stop before returning to Apple- 
Works. RamWorks even expands the 
clipboard. And auto segments large files 
so they can be saved on two or more 
disks. You can even have Pinpoint or 
MacroWorks and your favorite spelling 
checker in RAM for instant response. 
RamWorks, nothing comes close to 
enhancing AppleWorks so much. 


The Most Friendly, Most 
Compatible Card Available. 


Using RamWorks II couldn’t be easier 
because it’s compatible with more off 
the-shelf software than any other RAM 
card. Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard: 
Soft, FlashCalc, Pro-Filer, Managing Your 
Money, SuperCalc 3a, and MagiCalc to 
name a few (and ad hardware add on’s 
like ProFile and Sider hard disks). Ram- 
Works is even compatible with software 
written for Apple cards. But unlike other 
cards, RamWorks plugs into the Ie 
auxiliary slot providing our super sharp 


80 column text (U.S. Patent #4601081) in | 
| combine RGB color output with their 
; Memory cards, but that’s unfair for those | 
| who don’t need RGB and for those that 


a completely integrated system while 

leaving expansion slots 1 through 7 

available for other peripheral cards. 
RamWorks III is compatible with all 


Apple He’s, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of- 


; fered the largest memory for the Ile and 


RamWorks HI continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 


| most will ever need (1 meg is about 500; 
_ pages of text)...but if you do ever need 
| more than 1 MEG, RamWorks III has the 


widest selection of expander cards avail- 


| able. Additional 512K, 2 MEG, or 16 


MEG cards just snap directly onto Ram- 
Works Ill by plugging into the industry's 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 

If you've got some other RAM card 
thats not being recognized by your 
programs, and you want RamWorks III, 
you're in luck Because all you have to 
do is plug the memory chips from your 
current card into the expansion sockets 


; on RamWorks to recapture most of your 


investment! 


The Ultimate in RGB Color. 


RGB color is an option on RamWorks 
and with good reason. Some others 


do. Because if you don’t need RGB 
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Applied Engineering doesn’t make you 
buy it, but if you want RGB output 
you're in for a nice surprise because the 
RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 
composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 
claim is the best they have ever seen. 
Youll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB 
| Option is more than just the ultimate in 
color output because unlike others, it’s 

| fully compatible with all the Apple 
standards for RGB output control, mak- 
ing it more compatible with off the-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 

| because only the new RamWorks RGB 
option provides both Apple standard and 
IBM standard RGB outputs (cables in- 
cluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- 


ference and remember you can order 
the RGB option with your RamWorks or 
' add it on at a later date. 


True 65C816 16 Bit Power. 

| | RamWorks III has a builtin 65C816 

' CPU port for direct connection to our 
optional 65C816 card. The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 

' tons like running the Lotus 1-2-3™ 
compatible program, VIP Professional 
Our 65C816 card does not use another 


» full 8 bit compatibility. 


slot but replaces the 65C02 yet maintains | 


Endorsed by the Experts. 

A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks... 
like the product so much that I am 
buying one for my own system.” inCider 
magazine said “Ra hWorks is the most 


‘T wanted a 
memory card for 
my Apple that was 
fast, easy to use, 

| and very compat. 
ible; so I bought 
RamWorks.” 


Steve Wozniak, the creator 
of Apple Computer 


i 7 


powerful auxiliary slot memory card 
available for your Ile, and J rate it four 
stars...For my money, Applied Engineer- 
ing’s RamWorks is king of the hill” 
Apple experts everywhere are im- 


| pressed by RamWorks’s expandability, 


versatility, ease of use, and the sheer 


bd 

$ 
Be 
ert 
* 
ae 
pond 
ok 


power and speed that it adds to any Ile. 
With a RamWorks in your Apple, you'll 


' make IBM PC's and ATs look like 


slowpokes. 


Quality and Support of the 
Industry Leader 


RamWorks III is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 


| the inventor of large RAM cards for the 
| Apple. With our 5 year no hassle 


warranty and outstanding technical sup- 


| port, you’re assured of the most trouble 


free product you can buy. 
It's Got It All 


e 15 day money back guarantee 
e 5 year hassle free warranty insures 


coverage no matter where you 
purchase 
¢ Built-in super sharp 80 column display, 
(US. Patent #4601081) 
e Expandable to 1 MEG on main card 
e Expandable to 16 meg with expander 
cards, with NO slot 1 interference 
e Can use 64K or 256K RAMs 
e Powerful linear addressing 16 bit 
coprocessor port 
e Automatic AppleWorks expansion up 
to 3017K desktop 
e Accelerates AppleWorks 
e Built-in AppleWorks printer buffer 
_e The only large RAM card that’s 100% 
compatible with all Ile software 
e RamDrive™ the ultimate disk emula- 
tion software induded free 
e Memory is easily partitioned allowing 
many programs in memory at once 
e Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 
both Apple and IBM type monitors 
e Built-in self diagnostics software 
e Lowest power consumption (U.S. 
Patent #4601081) 


| e Takes only one slot (auxiliary) even 


when fully expanded 

| ¢ Socketed and user upgradeable 

e Software industry standard 

e Advanced Computer Aided Design 

e Used by Apple Computer, Steve 
Wozniak and virtually all software 
companies 


| e Displays date and time on the Apple- 


Works screen with any PRO-DOS 
compatible clock 
e Much, much more! 


RamWorks [Ill with 64K 
RamWorks lll with 256K 
RamWorks Ill with 512K 
RamWorks Ill with 1 MEG 
RamWorks (11 with 1.5 MEG 


$179 
$219 
$269 
$369 
$539 


RamWorks Ill with2to16MEG CALL 


65C816 16 Bit Card 
RGB Option 
Optional Software: 
Pinpoint with RAM 
Enhancement Software $79 
VIP Professional $219 


RamWorks IIL The industry standard 
for memory expansion of the Apple Ile. 

ORDER YOUR RamWorks II TODAY. 
9 am to 11 pm. 7 days, or send check 
| Or money order to Applied Engineering 

MasterCard, Visa and C.O.D. wekome. 
Texas residents add 5%% sales tax. Add 
$10.00 if outside USA 


$159 
$129 


| AE Applied Engineering’ 


P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 
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FC58- 
FDDA- 
FDED- 


000800- 
000801- 
000802- 


000803- 


000818- 
00081A- 


00082D- 
00082F- 


0008 3F- 
000840- 
000841- 
000842- 


000843- 


00084 8- 
000849- 
000949- 
0009 4B- 
00094E- 


000951i- 


000972- 


FC 


01 


ee ek kk ek ek ek ek ek ek ek kh et oe ok td 
= OOO CJA EWA) =| ON CON AUIS WA) 2 OO 
(elo lelelelelololelelolelololeleolololralelolo\@) 


G0) AO AO POND NO AO POND AD AD wed at at et et at es ot = © 
oo 


WP = OO ODI DN SW D = OW DNDN EWA) A OW COANDNEWD HOW ON 
[wleloleleleloleoloelolelolololelolololololalololelolojolololelolelaelololo) 


HOME -EQ $FC58 
PRBYTE .EQ $FDDA 
COUT ~EQ $FDED 
MA BSR BRANCH RELATIVE TO SUBROUTINE 
PER ; 1+1 When Subroutine is Nearby 
21 BRA }1 
Boe Ba eee eee See ea2 
~MA BSL BRANCH RELATIVE TO SUBROUTINE 
PER ;1+2 When Subroutine is Far Away 
21 BRL }1 
: . M 
TRIVIAL. EXAMPLE 
SEC SET EMULATION MODE 
XCE IN CASE CALLED FROM NATIVE MODE 


SAVE E-BIT 


PHP 
#.--Show bee bec eben cas subroutine calls-------- 


BCC 
#.--Show Page-Zerc Indirect data access 
PER 


4 


05 


#.--Return 


JSR HOM CLEAR S EN 

LDA #0 FOR NUM = O TO $FO STEP $10 
STA NUM 

JSR PRBYTE Print in hexadecimal 

>BSL PRBLNK Print two blanks 

PER :1+2 When Subroutine is Far Away 
BRL PRBLNK 

>BSR ADD.10 ...NEXT NUM 

PER :1+1 When Subroutine is Nearby 
BRA oe 


e+e NOT FINISHED YET 


PUT POINTER TO TEXT ON STACK 


PLA Now put pointer into page zero 
STA PTR 
PLA 
STA ae 
LDY # Point to beginning of text string 
LDA (PTR), Y Get next character of string 
BEQ .3 End of string 
JSR COUT 
INY 
BNE .2 ~» ALWAYS 
#.~--Show Stack-Indirect data acceSS--<----------------- 
PER TEXT POINTER TO TEXT ON STACK 
LDY fs Point to beginning of text string 
LDA (1,S),¥ Get next character of string 
BEQ .5 End of string 
JSR COUT 
INY 
BNE .4 oo ALWAYS 
ree POP OFF TEXT POINTER 


GET SAVED E-BIT 
RESTORE E 


to caller 


ADD $10 TO NUM 
SET CARRY IF WRAPS AROUND 


aa cns croncamderendent Text String/ 
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Simple Line-Input Subroutine.........+...eBOb Sander-Cederlof 


The other day I needed a simple subroutine to read a line of 
text into an assembly language program. The routine had to be 
short, work in both 40- and 80-columns, and allow very simple 
editing. It had to read directly from the keyboard, regardless 
of where the input vector at KSWL ($38,39) might be pointing. 


The following listing shows the result. READ.A.LINE is indeed 
Short and fulfills all the needs I had. Backspace is the only 
editing character. When you type a printing character, it is 
displayed and the underline cursor advances. When you type a 
backspace, the cursor backs up and replaces what was previously 
at that position. 


When you type a RETURN, the routine returns with the X-register 
pointing into the line buffer at the position where the RETURN 
ils stored. If you type an ESCAPE, it nulls the line you just 
typed. The line is still in the buffer, but READ.A.LINE 
returns with the X-register equal to zero. 


Inside READ.A.LINE I use the X~-register to track position in 
the line buffer. I don't explicitly keep track of position on 
the screen, at least in absolute terms. Wherever the cursor is 
when you call READ.A.LINE is the place where the first cursor 
will be displayed. Since I do all moving around on the screen 
by simply printing out characters or backspacing, all screen 
positions are relative to the beginning position. You can use 
READ.A.LINE inside a small window if you like, and the input 
line will wrap nicely when it comes to the edge of the window. 


Lines 1100-1120 handle the cursor by first printing an 
underline, and backspacing over it. Then when you type a 
character I will put it over the top of the cursor, and come 
back to line 1100 to display the next cursor. 


Lines 1130-1150 are the standard way to read the keyboard when 
you don't want any firmware interference. (The Apple IIgs has 
more hardware bells and whistles here, with the Front Desk 
Processor and all, but this method will still work.) 


When you type a backspace, I have to output a space to erase 
the cursor, then backspace twice and place a new cursor over 
the top of the character which was right before the old cursor. 
This is in lines 1350-1380. If the cursor is already at the 
beginning of the line, lines 1330-1340 will simply start over. 
Because of the way lines 1330 and 1340 are written, the maximum 
length line you can type and still use backspace is 128 
characters. 


I wrote a quick and dirty test program, to illustrate how to 
use READ.A.LINE. Lines 1500-1560 print out a prompting 
message. Line 1580 calls READ.A.LINE. The cursor will start 
right after the prompting message. Line 1600 tests for an 
ESCAPE, signifying a null entry. If you type RETURN, lines 
1610-1670 will display the message you just entered. 
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1000 *SAVE S.READLINE 
c000- 1020 KEYBOARD .EQ $C000 
C010- 19 0 STROBE -EQ $C010 
FD8E- 1050 CROUT .EQ $FD8E 
FDED- 10 0 cour -EQ $FDED 
1080 READ.A.LINE 
0800- A2 00 1090 .0 LDX #0 Start at beginning of line 
O0802- AQ DF 1100 .1 LDA #*_* Use underline for a oursor 
O804- 20 ED FD 1110 JSR COUT Print the Underline 
0807- 20 49 08 1120 JSR BSOUT .seand back up over it 
O80A- AD 00 CO 1130 2 LDA KEYBOARD 
O80D- 10 FB 1140 BPL .2 -ee- wait until key pressed 
O80F- 8D 10 CO 1150 STA STROBE 
ieee tee te 
0817- 90 OA 1190 BCC ‘3 CONTROL CHAR 
ee 
0 1D- 2 ED FD 1210 JSR COUT SHOW IT ON SCREEN 
(any aan a 2) ae 
o837- 69 9B 1383 «GaP aggpDACKSPACE 
Sig 6S 1 1gi BER jd) SCAPE —- now uP 
082D- DO DB 1290 BNE . .»sNOT <RETURN>, IGNORE IT 
O82F- 20 46 08 1300 JSR SPCOUT ERASE CURSOR FROM SCREEN 
0832- £8 1310 INX INCLUDE <RETURN> IN X-VALUE 
0833- 60 1320 : RTS RETURN TO CALLER 
0835- 30 C9 1380 ; BMI .0 .» ALREADY AT BEGINNING OF LINE 
0837- 20 46 08 1350 JSR SPCOUT ». SPACE 
O83A- 20 49 08 1360 JSR BSOUT .. «BACK SPACE 
08 D- 20 4 08 1379 JSR BSOUT .. AND ANOTHER 
0843- A2 00 1390 6 LDX #0 SIGNAL ESCAPE TYPED 
0845- 60 1400 : RTS 
0846 - Ag AO 1420 SPCOUT LDA ‘ " SPACE 
0849- AQ 88 14ko BSOUT LDA #$88 BACKSPACE 
O84B- 4C ED FD 1450 : JMP COUT 
1F- 1470 MAXLEN .EQ 127 
O84E- 14 0 WBUF -BS MAXLEN+1 
1500 TEST 
O8CE- A2 00 1510 LDX #0 PRINT OUT A PROMPT MESSAGE 
O8DO- BD F1 08 1520 .0 LDA PROMPT ,X 
or eas ae 
O8D7- EO OF 1590 CPX #PROMPT .LEN 
O8D9- 90 F5 15 0 : BCC .0 
O8DB- 20 00 08 1560 ; “JSR READ.A.LINE 
O8DE- FO 10 1600 BEQ .2 ESCAPE ABORTED IT 
O8E0- 20 8E FD 1610 JSR CROUT <RETURN> OUTPUT 
O8E3- A2 00 1620 LDX #0 PRINT OUT THE LINE YOU TYPED IN 
O8E5- BD 4E 08 1630 1 LDA WBUF,X 
Seen EB) een ++ ae 
O8EC- C9 8D 1620 CMP #$8D UP TO A <RETURN> 
O8EE- DO F5 1670 BNE .1 
O8FO- 60 1680 .2 RTS 
1690 Boshetec sco oath ete ete 


O8FD- BA AO AO 1700 PROMPT .AS -/Enter a line: / 
OF- 20 PROMPT . LEN EQ #-PROMPT 


Page 20.....-Apple Assembly Line.....April, 1987.....Copyright (C) S-C SOFTWARE 


Vieumaster SO 


Now run. 
AppleWorks on 
your II-and keep 
full 80 column 

compatibility! 


ALBEE RIA 


ae ee ie 
SURO MENS St Seas Set cas eps Ph ae) 


() ne look at the chart will give you some of the 


reasons there's only one smart choice in 80 
column cards for your Apple. But the real secret to 
Viewmaster 80's success is something even better: 

Total compatibility. 

Each Viewmaster 80 includes Our powerful Apple- 
Works expand software, allowing AppleWorks to run on 
the I+ with only 64K (or more) memory. (We recom- 
mend the RamFactor memory card, but any compatible 
Apple memory card will work.) The software provides 
our full range of AppleWorks enhancements, including 
expanded records, word processor, multi-disk saving, 
time and date display on screen with any PRO-DOS 
clock, and more! 

The Viewmaster 80 works with all 80 column 
applications, including DOS 3.3, PRO-DOS, CP/M, 
Pascal, WordStar, Format [H, Applewriter HH, dBase I, 
Visicalc, Multiplan, and Aiuadreds of others — includ- 
ing AppleWorks. 

Here are justia few of the powerful features the 
Viewmister 80 delivers for a great price ($149): 

* 80 Characters by 2+ lines * Fully compatible with all 
Apple languages and software * Highest compatibility 
with existing 80 column software * Very low power con- 
sumption * High speed (18 MHZ) scroll rate * Upper and 
lower case characters and true descenders, both inverse 
and normal, all on-screen editing functions are sup- 
ported ¢ User-definable cursor shape * Compatible with 
Apple Il, H+ and Ile * Five-year warranty 

Call today to order or for more information, 9 a.m. 
to 11 p.m. seven days, or send check or money order to 
Applied Engineering. MasterCard, VISA and C.O.D. wel- 
come. Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A. 


CPM us a registered trademark of Digital Research, Inc 


Fc Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 
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Friendly Decimal Print Subroutine.........e.eee.eeeJdan Eugenides 


Several years ago Bob S-C published a little subroutine to 
convert two-byte hexadecimal values to decimal and print them. 
I have written a similar subroutine, but mine allows you to 
print any character as a leading character when the number has 
less than five digits, or to have no leading characters at all. 
Bob's subroutine always printed leading zeroes. 


To use my subroutine, you put the number in the A- and 
X-registers (lo-byte in A, hi-byte in X), and the fill 
character in the Y-register. If you do not want any fill 
character, call my subroutine with Y=0. To make calling it 
easier, Bob S-C constructed a macro named PDEC, defined in 
lines 1490-1580 below. To print a number with no fill 
character, simply use the macro like this: >PDEC VALUE; to 
print with a fill character, use the macro with the fill 
character as the second parameter like this: >PDEC VALUE,“#". 


Now let's look at my subroutine. Lines 1110-1120 store the 
high byte of the number, and the fill character. I waited to 
store the low-byte of the number in line 1160, inside the 
conversion loop, to save a few bytes and cycles. 


Lines 1150-1380 comprise a loop controlled by X, counting down 
from 3 to 0. The loop prints out the first four digits and/or 
fill characters. xX indexes into a power-of-tens table. I 
first subtract 10000 as many times as possible, counting each 
subtraction in the Y-register. Since Y starts out as ASCII 0, 
it increments through successive ASCII digits. When the 
remainder is finally less than 10000, I print the first digit. 
Then the process is repeated for 1000, 100, and 10, 


Leading-zeroes may be either suppressed, or printed with your 
choice of fill character. The work is done in lines 1280-1340. 
I keep a flag in bit 7 of FLAG. This bit starts out 0 (See 
line 1140). As soon as I get a non-zero digit, I change the 
flag bit to 1 (see lines 1280-1300). If the flag bit isl, 
lines 1310-1320 will decide to print the digit regardless of 
its value. (We don't want to omit or replace ALL zeroes, only 
LEADING zeroes.) Lines 1330-1340 will decide whther to print a 
fill character or nothing at all. 


After printing the ten's digit, the remainder in NUM is the 
units digit in binary. All I have to do is add an ASCII "0" to 
change this remainder to ASCII, which I do in lines 1390-1400. 
By handling the unit's digit in this special way I Save extra 
logic which would have been required to make the value $0000 
print at least one zero and two bytes in my power-of-tens 
table, saving a total of six bytes. The cost is lines 1390 and 
1400 versus a simple RTS, or four bytes. This method is also 
faster, because I don't have to cycle though the loop counting 
down the unit's digit. 


For an exercise, you might try extending my subroutine to 
convert 3- or 4-byte values. It is really not too difficult. 
Of course, you would no longer be able to pass the value to be 
converted in the A- and X-registers. For 3-byte values, the 
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SPECIAL !!! EXPANDED RAM/ROM BOARD: $39.00 
Similar to our $30 RAM/ROM dev board described below. Except this board has two sockets to hold your choice 
of 2-2K RAM, 2-2K ROM or even 2-4K ROM for a total of 8K. Mix RAM and ROM too. Although Apple limits 
access to only 2K at a time, soft switches provide convenient socket selection. Hard switches control defaults. 
IMPROVED |!! Jf IN A MAC (ver 2.0): $75.00 

Now includes faster graphics, UniDisk support and more! Bi-directional data transfers are a snap! This Apple II 
emulator runs DOS 3.3/PRODOS (including 6502 machine language routines) on a 512K MAC or MACPLUS. All 
Apple |i features are supported such as HI/LO-RES graphics, 40/80 column text, language card and joystick. 
Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk accessories and support 
for 4 logical disk drives. Includes 2 MAC diskettes (with emulation, communications and utility software, plus 
DOS 3.3 and PRODOS system masters, including Applesoft and Integer BASIC) and | Apple I! diskette. 


SCREEN.GEN: $35.00 
Develop HI-RES screens for the Apple |i on a Macintosh. Use MACPAINT (or any other application) on the MAC to 
create your Apple |i screen. Then use SCREEN.GEN to transfer directly from the MAC to an Apple II (with 
SuperSerial card ) or lic. Includes Apple Il diskette with transfer software plus fully commented SOURCE code. 


MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MiDi-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-MAGIC compatible 
with Apple II family using Passport MIDI card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. Special functions (like expanded, compressed etc.) supported. 
Includes HIRES screen editor to create custom fonts and special graphics symbols. For Apple Il, Il+, //e. Specify 
printer: Apple Imagewriter Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/85, or Okidata 92/192. 
* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembler to investigate the inner workings of Apple Il machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables. displaced object code & even provides iabel substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASNM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 

Converts a ‘dumb’ parallel printer 1/F card into a ‘smart’ one. Simple command menu. Features include 
perforation skip, auto page numbering with date & title, large HIRES graphics & text screen dumps. Specify 
printer: MX-8G with Graftrax-80, MX-100, MX-80/100 with Graftraxplus, NEC 8092A, C.jltoh 8510 
(Prowriter), OkiData 82A/G3A with Okigraph & OkiData 92/93. 

‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone © 
detection, audible ring detect, ring-back, printer buffer, 80 col card & shift key mod support. 

RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnOO-CnFF and $CB00-CFFF. 
C-PRINT For The APPLE //c: $69.00 


Connect standard parallel printers to an Apple //c serial port. Separate P/S included. Just plug in and print! 


Seem ewe ew Be we wee ew nw ew ewe we wee ee ee ew wwe ew Oe ee ew we we ee eee ee ee 2 ee ee eee ew ee wm we ee ee eee 


Unless otherwise specified, all Apple I! diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
ECECEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEESE 
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power-of-ten tables would have to be extended in both 
dimensions: 


TENTBL .DA #10, #100, #1000, #10000 
-DA #100000, #1000000, #10000000 
TENTBM .DA /10,/100,/1000,/10000 
-DA /100000,/1000000,/10000000 
TENTBH .DA #0,#0,#0,#0 
-DA /100000/256 ,/1000000/256 ,/10000000/256 


You would also have to extend the comparison and subtraction 
code inside the loop. Why not try it? 


1000 SSAVE S.PRINT.DECIMAL 
inao = By Jan Eugenides and Bob S-C 
1080 ® Call with A as follows: 
aceG ad A) = Tewet ve of number to be printed 
1060 # X) = high byte of number 
are : Y) = fill character (or 00 if no fill) 
1080 Saseesesces- 2 oes 5 eens =- s 
FDED- 100 COUT -EQ $FDED 
0800- 8E 52 08 1110 PRDEC STX NUM+1 Store high byte of number 
0803- 8C 50 08 1120 STY FILL Store fill character 
0806- A2 03 1bS LDX #3 FOR X = 3 TO 0 
0808—- 8E 4F 08 1140 STX FLAG Clear bit 7 in pead ing zero flag 
OSOB- AO BO 1150 .1 LDY #"0* Start with digit = 
O80D- 8D 51 08 1160 .2 STA NUM compere user to power of ten 
ee te q ae ay agen 10°(X+1) ... lo=byte 
- + 
0816- FD 4B 08 1190 SBC TENTBH,X 10°(X+1) ... hi-byte | 
0819- 90 OC 1200 BCC .3 Remainder is smaller than 107(X+1) 
081B- 8D 52 08 1210 STA NUM+1 Store remainder hi-byte 
O81E- AD 51 08 1220 LDA NUM Get remainder lo-byte 
0821- FD 47 0 oie SBC TENTBL ,X 
O82h- C8 1240 INY png conene ASCITI digit 
1260 *---Print a digit---------------- 
0827- 98 val 3 TYA digit in ASCII 
0828- C9 BO 1280 CMP #"0* Is it a zero? 
O82A- FO 03 1290 BEQ .4 SG YEMs might be leading zero 
082C- 8D AF 0 1300 STA FLAG so clear leading-zero flag 
O82F- 2C AF 08 1310 .4 BIT FLAG If “this is leading~zero, will be + 
0832- 30 05 1330 BMI .5 ee not a leading zero 
0834- AD 50 08 1 Bo LDA FILL : 1 leading zero, so use fill-char 
OR 3g - FO 0 13 0 BEQ .6 .-Oops, fill-char 
0 - 20 ED FD 1350 .5 JSR COUT Print the digit or fill-char 
083C- 51 08 1300 6 LDA NUM Get lo-byte of remainder 
083F- CA 1 i DEX Next X 
O840- 10 C 1380 BPL .1 Go get next digit 
O842- 09 B 1390 ORA #"0* Change remainder to ASCII 
O844- NC ED FD ao E JMP COUT Print Unit's digit & RTS 
O847- OA 64 E8 
aba aa 00 03 1420 TENTBL .DA #10, #100, #1000, #10000 
O84E- 27 Le TENT BH -DA /10,/100,/1000, /10000 
O84F- 1450 FLAG -BS 1 
0850- 1460 FILL .BS 1 
1490 -ma pdec 
1500 lda j1 
1510 ldx J1+1 
1520 -do |#>1 
1330 idy eyo" 
1540 -else 
1550 ldy #0 
1560 fin 
1570 jsr prdec 
1580 en 
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> mum number of records in the database and 


' Works, Pinpoint, BPI, Managing Your Money, 


| Write, MouseDesk, MouseCalc, Sensible 
| Speller, Applewriter Ile, Business Works, 


Ram Factor 


Boot any IF, Ile or Ics and be up and running your 
Javorite software in less than 1 second 


Now anyone with an Apple II+, Franklin, Laser 128, Apple He or IIcs preferring to use 
slots 1 through 7 can now enjoy the speed and performance that theyve been waiting for. 
With RamFactor, you'll be able to instantly add another 256K, 512K, or a full 1 MEG on 

the main board and an expansion connector can address an additional 16 MEG of 
memory for possible future expansion. Since virtually all software is automatically 
compatible with RamFactor, you'll immediately be able to load programs into RamFactor 
for instantaneous access to information. You'll also be able to store more data for larger 
word processing documents, bigger data bases, and expanded spreadsheets. And with the 
battery back-up Option, you can switch on vour Apple and your favorite software will 

be up and running in less than 1 second! 


He, Franklin, or Laser 128 when used with an 
80 column display. RamFactor, no other 
standard slot card comes dose to enhancing 
AppleWorks so much. 


Very Compatible 
All the leading software is already com- 
patible with RamFactor. Programs like Apple- 


Dollars and Sense, SuperCalc 3A, PFS, Mouse. 
a The “Instant On” Apple. 


With the RamCharger 
Ss BS battery backup op- 
: von, RamFactor 
will retain pro- 
grams and data 
during power 
failures or even 
when you tum your computer off And 
because RamFactor plugs into slots 1-7, its 
the only memory card that can cold boot 
an Apple without using slow floppy or hard 
disks. An available “Y" cable allows one 
RamCharger to power two RamFactors. 


ReportWorks, Catalyst 3.0 and more. And 
RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 
and CP/M compatible. In fact, no other slot 
1-7? memory card is more compatible with 
commercial software. 


| RAMCHARGER | 


AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
intemal memory limits, increasing the maxi- 


| Powerful Program Switcher 
With RamFactor, you can organize 
memory into multiple work areas and switch 


lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load all of AppleWorks into | 


Features: 

e 256K to 1 MEG on main board. Expansion 
connector for possible further expansion to 
16 MEG. 

e Fully Apple II Memory Expansion 
compatible 

e Compatible with Apple Ile, II+, Iles, 
Franklin and Laser 128 

e Battery back-up option allows you to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal, and standard CP/M 

e Built-in RamDrive™ software (a true RAM 
disk not disk caching) 

e Systems are directly bootable from Ram- 
Factor if desired 

e Built-in self diagnostic software 

e Automatic expansion with AppleWorks 1.3 
or 2.0 

e Allows Apple [I+ and He to run your 
AppleWorks without buying any 
additional software 

e Accelerates AppleWorks 

e Displays time and date on the AppleWorks 
screen with any ProDos clock 

e Fits any I/O slot except slot 3 

e Fully socketed and user upgradeable 

e Much, much more 


RamFactor with 256K 
RamFactor with 512K 
RamFactor with 1 MEG 


$239 
$279 
$359 
CALL 
$179 

$24 


RamFactor with 2-16 MEG 
RamCharger backup option 


“¥”" cable 
(Allows one RamCharger to power two RamFactors.} 


Order RamFactor today — with 15 day 
money back guarantee and our “no hassle” 
five year warranty. See your dealer or cal 
(214) 241-6060, 9 am to 1] pm, 7 days, or 
send check or money order to Applied 
Engineering, MasterCard, Visa and C.O.D. 
welcome. Texas residents add 6% sales tax 
Add $10.00 if outside USA 


RAM dramatically increasing speed and 
eliminating the time required to access the 
program disk, it will even display the time 
and date on the AppleWorks screen with 
any ProDos clock RamFactor will automati- 
cally segment large files so they can be 
saved on 5%”, 3¥2'", and hard disks. All this 
performance is available on the Apple T+, 


| AppleWorks to DOS 3.3 to CP/M to Pascal to 


between them. Each work area can contain 
different programs and even different operat- 
ing systems. Now you can switch from one 
program to another or even switch from 


cK Applied Engineering” 
The Apple enbancement experts 


(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


ProDos in under a second. And with our 
battery back-up option, vou can have 
permanent storage for up to 20 vears. 
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1590 
FD8E- 1600 CROUT .EQ $FD8E 
1610 


0853- 1620 T >PDEC VAL1,# 
0853- AD 9A 08 0000> lda VAL1 
0856— AE 9B 08 0000> ldx VAL1+1 
0000> .do 2>1 
0859- AO A3 0000> ldy #*#* 
0000> -else 
0000> .fin 
O85B- 20 00 08 0000> dsr rdec 
O85E- 20 8E FD 1630 JSR CROUT | 
0861- 1640 >PDEC VAL2, 
OR 1- AD 9C 08 0000> lda VAL2 
O864- AE 9D 08 0000> ldx VAL2+1 
0000> -do 2>] 
0867- AO DE 0000> ldy #°" 
0000> else 
0000> -fin 
0869=- 20 00 08 0000> gen rdec 
086C- 20 8E FD 1650 JSR CROUT 
ORE 1660 >PDEC VAL3 
O86F- AD 9E 08 0000> lda VAL3 
0872- AE 9F 08 0000> ldx VAL3+1 
0000> -do 1>1 
0000> ~else 
0875=- AO 00 0000> ldy #0 
0000> fin 
0877=- 20 00 08 O0000> ger rdec 
OR TA- 20 8E FD 1670 JSR CROUT 
O87D- 1680 >PDEC VAL4 
087D=- AD AO 08 0000> lda VAL4Y 
0880- AE Ail 08 0000> ldx VAL4+1 
0000> edo 1>1 
0000> else 
0883- AO 00 0000> ldy #0 
0000> fin 
0885- 20 00 08 0000> ar rdec 
0888- 20 BE FD 1690 JSR CROUT 
O88B- 1700 >PDEC VAL5," * 
O88B- AD A2 08 0000> lda VAL5 
O88E- AE A3 08 0000> ldx VAL5+1 
0000> do 2>1 
0891- AO AO 0000> ldy #* * 
0000> else 
0000> fin 
0893 - 20 00 08 0000> aor rdec 
0896- 20 8E FD 1710 JSR CROUT 
0899- 60 1720 RTS 
1730 
O89A=- D2 OH 1740 VAL1 DA 1234 
089C- 4F 00 1750 VAL2 -DA [2 
O89E- FF FF 1760 VAL DA 33° 
O8A0- 4B 1B 17 R0 VAL -DA 6987 
O8A2- 17 00 1780 VAL5 DA 2 


Note from American Foundation for the Blind 


The American Foundation for the Blind is managing a database of 
individuals with hands-on experience with computers, low vision 
aids, talking products, and other devices for the blind and 
visually-impaired. About 500 users and evaluators are 
currently listed in their database, and are available to help 
in training, purchase decisions, and evaluation of new 
products. If you have related experience are interested in 
helping, or could use such help yourself, you can contact their 
National Technology Center at 1-800-232-5463. 
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With the TransWarp™ accelerator, your He™or IT+™ 
is 40% faster than the IIcs! 


Computing at warp speed! 

Its an experience you shouldn't miss. And with TransWarp, 
you wont have to. Because ‘Trans; wp pal run vour He or 
I+ software 3.6 times faster — thats 40% faster than 
Apple's [cs' 

No more vawning while vour Apple ™ slowly rearranges 
text or calculates spreadsheets. With 250K of ultrafast RAM, 
TransWarp speeds up aff Apple software including Apple 
Works, and all educational software, graphics and games. And 
its compatible with all standard peripheral cards (such as Ram 
Works and Apple memory cards), hard disks. 3! 2" UniDishs. 
80-column cards, modems, clock cards. mouses end more! You 


name it. TransWarp accelerates it, There's even a lo bit upyrade 


chip available. 


“TransWarp ts great! 1 bave 
replaced all my other 
accelerators with it!” 


Sere Wootnak, the creator 
Of \pple Compiter 


An important difference. 

With TransWarp, software runs up to three tames bester than 
with other cards, since the others cunt accelerate programs in 
auxiliany memory Thats why dransWarp is so much faster than 
the rest. Nearly all of today’s more powerful programs run par: 
tially or completely in auxilian, memory programs like Apple- 
Works, Pinpoint, Managing Your Money, SuperCale 3a, BPE and 
Pascal, to name afew, Why sete for a card that accelerates 
only part of the memory? 

There's one more important difference Since TransWarp 
doesn tuse memory caching. vou get consistent high speed 
performance. 

A cinch to use. 


Ss plug TransWarp into any slot in vour Apple TH. t+) or 
He including slot 3 in the Ie. list: indy vou Tl be computing 


at speeds vou only dreamed about before. And should vou 
ever wish to run at normal speed, simply press the ESC kev 
while turning vour Apple on. 

Since TransWarp is completely transparent. you wont need 
preboot disks or special software. Its ready to go right out of 
the package! 

Speed = Productivity 

Imagine the productivity gains vou ll achieve when vour 
programs are running over three times faster, TransWarp is so 
powerlul, vour Apple will make [BM PCs™ and even ATs™ 
look like slowpokes. 
°4.0 MHZ 65C02 * Totally transparent operation 
* 250K of ultra-fast on-board with all software 

RAM ° Plugs into any slot, including 
* Accelerates main cid slot 3 on the Apple He 
auxiliary memory * Accelerated 16 bit option 
*Low power consumption for available 
cool operation *S-vear Warranty 
Satisfaction guaranteed! 
Give vor Apple the TransWarp advantage. With our risk-free 


IS-day money back guarantee. vou have nothing to lose but 
wasted time, Call today! 


TransWarp accelerator $279 
16 bit upgrade Cmiav add later ) $89 
For fast response: 

Call Applied Engineering, 9 am. to PE p.m. 7 daws at (214) 
241-0000. Mi ne rCard, VISA and C.O.D. welcome. Texas resi- 
dents ada S's% sales tax, Add $10.00 if outside U.S.A. Or mail 


check or money order to Applicd Engineering. PO. Box 798, 
Carrollton. TX 75000, 


yn Applied Engineering 
The Apple enbancement experts. 


P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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Some Handy MOVE M@cCroS......ceeeeeeveeeeee BOD Sander-Cederlof 


Some time ago Bruce Love, a mathematics teacher at Hillcrest 
High School in New Zealand, sent me a macro he has found quite 
handy. It is shown in lines 1010-1090 in the listing below. 
It can be used to generate in-line loops to copy a group of 
bytes from one place to another. The macro works with any 
group up to 256 bytes long. It is really quite flexible, as 
the several examples in lines 1460-1550 reveal. Note that the 
source and destination may be either absolute or indirect in 
form. Furthermore, the length may either be stored ina 
variable or in the immediate form. 


I added the SET macro (lines 1170-1230) to set up a pointer, to 
simplify using the MOVE macro with pointers in page zero. An 
example of its use is in lines 1490 and 1500. 


There is another macro that I have found useful for moving 
larger chunks of RAM around. I use it eSpecially in ProDOS 
SYSTEM files for relocating program sections. See lines 
1100-1160 for the definition of the COPY macro, which moves up 
to 256 pages from source to destination. The parameters for 
COPY are reminiscent of the monitor M-command. For example, to 
copy $4B00 through S$5FFF to a destination beginning at $6A00 
the monitor command would be “6A00<4B0O0.5FFFM". The equivalent 
COPY macro would be "COPY S$6A00,$4B00,S5FFF". 


With both of these macros, beware of overlapping the range of 
the source and destination just as you would with the monitor 
M-command. Unless, of course, you know what you are doing and 
are doing it on purpose. For example, you can copy the first 
character of a block to all positions in the block like this: 


>MOVE BUFFER,BUFFER+1,LEN 


As is usually the case with macros which generate code, the 
code will probably not be as efficient as you could write given 
more knowledge of the overall situation. However, macros like 
these can shorten the time to develop programs, and thus they 
are worthy in spite of their possible inefficiencies. 


Les goAVE MOVE .MACROS 
1020 -MA MOVE source,destination, length 
1030 LDY #0 
1040 :1 LDA j3o¥ GET SOURCE BYTE 
1050 STA J2,Y STORE DEST. BYTE 
1060 INY NEXT BYTE 
1079 CPY 3 
0 BCC : + ITF MORE 
1090 . EM 
1100 #---------- ~~~ 
1110 -MA COPY destination,src.start,src.end 
1120 LDA /]1 DESTINATION PAGE 
1130 LDY /J2 SOURCE BEGINNING PAGE 
1140 LDX /]3-J]2+256 # OF PAGES 
1150 JSR COPY. PAGES 
1160 . EM 
ae $n ne me ee nen nnn en eee 
1180 -MA SET pointer, value 
1190 LDA #]2 
1200 STA ]1 
1210 LDA /J2 
1220 STA ]1+1 
1230 . EM 
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12 
00- 1250 SPTR .EQ $00,01 
02- 1260 DPTR .EQ $02,03 
0 - 1270 LENGTH .EQ $04 
0200- 1280 & BUFFER .EQ $200 
1300 COPY. PAGES 
0800- 85 03 1310 A DPTR+1 
0802- 8h 01 1320 STY SPTR+1 
O804- AO 00 1 30 LDY #0 
0806- 84 02 ~=1340 STY DPTR 
0808- 84 00 1350 STY SPTR 
O80A- B1 00 1360 1 LDA (SPTR) 
O80C- 91 1370 STA (DPTR),Y 
O80E- C8 1380 INY NEXT BYTE 
O80F- DO 1390 BNE .1 .«eKEEP GOING 
0811- E6 01 1400 INC SPTR+1  ...END OF PAGE 
0813- E6 1410 INC DPTR+1 
0815- CA 1420 DEX NEXT PAGE 
0816- DO F2 1430 BNE .1 .« KEEP GOING 
0818- 60 14h RTS .» «FINISHED 
1460 SAMPLE. MOVES 
0819- 1470 MOVE $500, , $600, #40 
08 19- AO 00 +~0000> up 
081B- B9 00 05 00005 :1 LDA $500,Y GET SOURCE BYTE 
081E- 99 00 06 0000> STA $600,Y STORE DEST. BYTE 
0821- C 00005 INY NEXT BYTE 
0822- CO 28 0000> CPY #40 
O824- 90 F5 0000>, BCC :1 .».IF MORE 
0826- 1490 >SET SPTR,BUFFER+10 
0826 - 49 0A 0000> LDA #BUFFER+ 10 
0828- 85 00 00005 STA S 
O82A- AQ 02 #0000 LDA ORUFFER+10 
082C- 85 01 0000> STA SPTR+1 
082E- 1500 >SET DPTR,BUFFER+40 
O82E- AQ 28 0000> LDA #BUFFER+40 
0830- 85 02 0000> STA DPTR 
0832- A9 02 0000> LDA /BUFFER+40 
0834- 85 0 0000> STA DPTR+1 
0836- AQ O 1510 LDA #9 
0838- 85 0 1520 STA LENG 
083A- 1530 >MOVE (SPTR), (DPTR ) , LENGTH 
083A AO 00 ~=©.0000> LDY 
083C- B1 00 00005 :1 LDA SPTR) ,Y GET SOURCE BYTE 
O83E- 91 02 00005 STA (DPTR).Y STORE DEST. BYTE 
0840- C8 0000> INY NEXT BYTE 
0841- Ch O4 0000> CPY LENGTH 
0843- 90 F7 0000> BCC :1 .»IF MORE 
0845- 1550 >MOVE ,BUFFER, (DPTR) , #10 
ie BO 09 02 Oo00> 21 rk BU 0 
= : B 
O84A- 94 02 ~ 00005 ut PUERES: Pe ORE BESE BLTi 
O84C- C8 0000> T BYTE 
O84D- CO OA 00009 cPY #10 
O84F- 90 F6 0000> BCC :1 .»eIF MORE 
1560 @ecehesee so cece ee oe ee 
15 0 SAMPLE. COPIES 
0851- 1580 >COPY 6400, $4B00, $5FFF 
0851- A9 6A  0000> LDA /$6A00 DESTINATION PAGE 
0853- AO 4B  0000> LDY 7$4B00 SOURCE BEGINNING PAGE 
0855- A2 15 0000> xX / SEPF -$4B00+256 # OF PAGES 
0857- 20 00 08 0000> ish COPY. PAGES 
085A- 1590 >COPY 5000, $2200, $4AFF 
O85A- AQ 50 0000> LDA /$500 DESTINATION PAGE 
085C- AO 22 0000> LDY /$220 o SOURCE BEGINNING PAGE 
O85E- A2 29 0000> LDX /$4AFF-$2200+256 # OF PAGES 
0860- 20 00 08 0900> JSR COPY. PAGES 
0863- 1600 >COPY $1000, BUFFER , BUFFER+255 
0863~ AQ 10 0000> LDA /$1000 DESTINATION PAGE 
0865- AO 02 00005 LDY / UFFER SOURCE BEGINNING PAGE 
0867 - A2 01 0000> LDX /BUFFER+255-BUFFER+256 # OF PAGES 
0869- 20 00 08 00005 JSR COPY. PAGES 
086C- 60 1610 : RTS 


New Supplement to "Beneath Apple ProDOS" Available 


Quality Software has published a new supplement to for “Beneath 
Apple ProDOS," which includes information on ProDOS versions 


1.2 and 1.3. It is 30 pages longer than the previous edition, 
which covered version 1.1.1 of ProbDOoS. 


You might be wondering, “What is a supplement, anyway?" The 
book “Beneath Apple ProDOS“* ("BAP") contains much reference 
Material needed to really take advantage of ProDOS 
Capabilities. While other books now cover much of the same 
ground, "BAP“ was the first one to put it all into print. The 
supplement, however, is unique: it contains a complete 
description of the internal details of both the ProDOS MLI 
kernel and BASIC.SYSTEM. If you are at all involved with the 
inner works of ProDOS, or are having trouble finding out the 
REAL scoop on some issues, you NEED the supplement. I have 
used my copies extensively, and depended heavily on it when 
writing the ProDOS version of S-C Macro Assembler. 


The original supplement, for versions 1.0.1 and 1.0.2 cost $10. 
The second and third editions are $12.50 each. Incredibly 
low-priced! You must order these directly from Quality 
Software, at 21610 Lassen Street #7, Chatsworth, CA 91311. As 
I understand it, the supplement is only sold to owners of 
"BAP", and you have to use the coupon found on page 8-9 of 
"BAP" to do the ordering. (“BAP” itself is $19.95 retail, but 
we sell it for $18 here.) 


RAMWORKS" 


ACCEPT NO SUBSTITUTES. 
BECAUSE THERE AREN'T ANY. 


Thess only one card like RamWorks. We’ve got the best hardware 
design. We supply the best software and we've got the best support from 
software companies. 


If someone tempts you with an imitation, please get both sides of the 
story. You'll discover why RamWorks offers the best enhancements to 
AppleWorks and other programs, and at the lowest price. 


GUARANTEED! 


214-241-6060 AR 


“We Set the Standard” 
9 AM - 11 PM APPLIED ENGINEERING 
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Serial Pro’ 
The intelligent 
multifunction card from 
Applied Engineering. 


eee eee 


Serial Pro is a powerful mulufunction card for the Apple Ile. 
11+, Gs and compauble computers. Serial Pro combines a 
powerful senal port for interfacing to a printer, modem or other 
serial device, with a full function clock/calendar. Serial Pro's serial 
port is compauble with virtually all letter quality and dot mauix 
printers, including Apple's Imagewniter and Imagewriter II, and 
can communicate with the fastest extemal modems at baud rates 
from 30 to 19,200. 

Set up is easy, because unlike other cards, there are no switches 
tO program serial parameters or disks to use. Serial Pro has a 
built-in setup screen that allows all parameters to be set And on: 
screen help that makes it super-easy. An on-board battery stores 
vour selections for over 20 vears, but vou can change them at 
anv ume. Serial Pro is the perfect upgrade for Super Serial card 
owners looking for more performance or a built-in clock 


Serial Port Features) e Fully Super Serial Card compauble but 
more versatile and easier tO use e Compauble with printers 

e Compatible with modems — e Prints graphics to printer (without 
software) in normal mode, 90° rotation, double size. side by side. 
and black white inversion —e Variable word length. number of 
stop bits and parity selection —e Crystal conuolled circuits are 
used to provide ultra accurate baud rates. 


Clock Calendar Features) e ProDos, DOS and AppleWorks 
compatible. Displays time and date on the AppleWorks screen 
e Automatically ime and date stamps AppleWorks files ¢ 20 
vear auto recharging nickel-cadmium batters e Realtime inter: 
muptse Built-in on screen time and date settings (no software 
needed) — e Does not use phantom slots. 

Serial Pro is perfect for Apple He. T+. HG» or compatible 
owners in need of a serial port or clock: calendar or both. But 
unhke other nulufuncuon cards on the market Serial Pro does 
not use phantom slots. socal the slots in vour computer are 
use.tble 

Sena Pro comes complete with manual cable and instrucdons 
for connecting. toll the leading: printers and modems. 


Seal Pro $159 


Order Todayt sce vou dealer on call Appled Engineering. 9 am. 
tO TP pan chins, On send cheek on mones order to Applied 
Engineering Master and VISA ind © Of) welcome Texits 


residents dab ott. sales box Neda SPO00G) Outside LOS A 


FE APPLIED ENGINEERING” 
The Apple enbancementt experts 
(214) 241 OOOO 


Pod Tos 


OM Crtretltor PN oGhOG 
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With the 
7-80 Plus; run 
over 5000 new 

CP/M’ programs. 


Now, get two computers 
in one and all the 
advantages of both. 


nter the CP/M wodd with the new Z-80 Plus card from 

Applied Engineering, and inwoduce vour Apple Ie, Has or 
IE+ to thousands of CP/M programs. Only the 2-80 Plus comes 
standard with the new 5.1 software, the most advanced svstem 
ever for running CP/M programs. 

The new 5.1 boasts advanced features like builtin disk 
emulation for popular memory expansion boards, boosting both 
system speed and storage capacity. And menu-driven utilities that 
let vou get to work faster. The 7-80 Plus also lets vou run older 
CP/M programs —all the way down to Version 1.6 (2.2 is the 
most popular). 

The 2-80 Plus is the only card on the market capable of 
accessing more than 64K. If you have an extended 80-column 
card, all 128K is usable. And if vou have RamW orks, RamFactor, 
osRam. csRam Plus, or an Apple memory card in vour He, Has or 
II+. up to 1088K is available. 

Each 2-80 Plus comes with our CP/M Ram Drive software, 
enabling most memory cards to work as a high-speed Ram disk 
so CP/M software can run up to Meena: times faster So packages 
like WordStar, dBASE 1, Turbo Pascal and most others run at 
blinding speed. 

Simply plug the 7-80 Plus into any slot in vour Apple. You'll 
get the benefits of pvo Computers in one- all at an unbelievably 
low price Conly $149!). 


e Fully compatible with ALL CP/M software — e Fully compatible 
with 5'4" arid 32" disk drives as well as most hard disks includ: 
ing the Sider =e Fully compatible with Microsoft disks (no pre- 
boot required) — e Specifically designed for high speed opera- 
ton — @ Runs WordStar, dBASE HH, Turbo Pascal. and ALL other 
CP/M software with 0 pre-boot — e@ Semi-custom LC. and low 
parts count allows Z-80 Plus to fly through CP/M programs with 
extremely low power consumption (we use the Z-80B) e Does 
EVERYTHING other Z-80 boards do, pis Z-80 interrupts 

® Five-vear warranty 


To get vour 7-80 Plus or for more information see vour 
dealer, or call 214-241-6000 9 a.m. to 1] p.m. seven davs. or send 
check or money order to Applied Engineering. MasterCard, VISA 
and C.O.D. welcome. Texas residents add 518% sales tax. Add 
$10.00 outside U.S.A 


Fu Applied Engineering” 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


CPM a registered tademirk of Digti Reser hy 
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A Note about Chessmaster 2000 


Gina Montagano, of the Software Toolworks, recently sent me 
"Chessmaster 2000". If you have not heard of it, Chessmaster 
is a really good chess-playing program which will run on the 
Apple II family. It is also available for Mac, IBM, and 
others. I bought Microchess back in 1977, and Sargon in 1978; 
they did well, considering they ran in such small machines. 
Microchess would fit in a 4K Apple! We have come a long way 
Since then. Chessmaster has many nice features, is the current 
reigning “champion"“, and is well worth the $49.95 price. (My 
ll-year-old stepson Matthew figured out a neat way to beat it. 
He let it tromp all over him, all the way to checkmate. Then 
he stepped back one move, swapped sides, and won!) Some 
features: display board in color or monochrome, 2-D or 3-D; 20 
levels of competence, plus one that purposely makes occasional 
obviously bad moves; optional hints for your best move; huge 
opening book; library of famous games; and on and on. 

Negative: copy protected, although you may order a backup copy 
for $5. Chessmaster 2000 is available at most software stores. 


— 5 oft. 


Basic—like macros for the S-C Macro Assembler. 
Available for the Apple If, I +, //e, and //c. 

Uses whatever DOS your S-C Macro Assembler uses. 
Soon to be released for PRODOS. 

Source code included with every disk!!! 

Cost? A paltry $30.00!!! 


To Order — Send Check or Money Order to: 


PR Mark Manning 


Simul | 
Beesu Canes c/o Baggy Games 


P. 0. Box 591894 
Houston, Texas 7?259-1694 


Apple is a registered Trademark of Apple Computer Inc. 
The S-C Macro Assembler is produced by The S-C Software Corporation. 
EnterSoft is produced by Mark Manning/Simulacron |I/Baggy Games 


Apple Assembly Line (ISSN 0889-4302) is published monthly by S-C SOFTWARE 
CORPORATION, P.O. Box 280300, Dallas, Texas 75228. Phone (214) 324-2050. 
Subscription rate is $18 per year in the USA, sent Bulk Mail; add $3 for First 
Class postage in USA, Canada, and Mexico; add $14 postage for other countries. 
Back issues are $1.80 each (other countries inquire for postage). A 
subscription to the newsletter and the Monthly Disk containing all source code 
is $64 per year in the US, Canada and Mexico, and $87 to other countries. 


All material herein is copyrighted by S-C SOFTWARE CORPORATION, all rights 
reserved. (Apple is a registered trademark of Apple Computer, Inc.) 
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